Title: Image Field
Published: February 20, 2025
Last modified: February 21, 2025

---

# Image Field

## In this article

 * [Key Features](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/image/?output_format=md#key-features)
 * [Settings](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/image/?output_format=md#settings)

[ Back to top](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/image/?output_format=md#wp--skip-link--target)

The Image field provides a dedicated interface for uploading and selecting images
through the WordPress media library. It offers preview capabilities and multiple
return format options.

## 󠀁[Key Features](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/image/?output_format=md#key-features)󠁿

 * Media library integration
 * Image preview
 * Size restrictions
 * Format validation
 * Multiple return formats

## 󠀁[Settings](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/image/?output_format=md#settings)󠁿

 * Preview Size – Thumbnail display size
 * Library – Restrict to uploaded or all images
 * Min/Max Width/Height – Image dimension limits
 * File Size Restrictions – Control upload sizes
 * Return Format – Array, URL, or ID

First published

February 20, 2025

Last updated

February 21, 2025

Edit article

[ Improve it on GitHub: Image Field ](https://github.com/wordpress/secure-custom-fields/edit/trunk/docs/features/field/image/index.md)

Changelog

[ See list of changes: Image Field ](https://github.com/wordpress/secure-custom-fields/commits/trunk/docs/features/field/image/index.md)

[  Previous: Using the Icon Picker Field](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/icon-picker/icon-picker-tutorial/)

[  Next: Using the Image Field](https://developer.wordpress.org/secure-custom-fields/code-reference/fields/image/image-tutorial/)