WordPress Media Settings

Configure default image sub-sizes and upload organization while understanding what the settings do not change retroactively.

4 min read

  • Guide
  • Beginner
  • 4 minutes read
  • Reviewed August 5, 2026
  • WordPress administration and configuration

The Media Settings screen controls selected defaults used when WordPress processes uploaded images.

It usually contains dimensions for thumbnail, medium and large image sizes, an optional cropping rule and a setting for organizing uploads into year and month folders.

It does not control every media size or every storage decision.

Generated Image Sizes

When an image is uploaded, WordPress can create additional files at registered sizes. Core commonly provides thumbnail, medium and large sizes. Themes and plugins can register more.

The exact derivatives depend on the original dimensions, active software, server image-processing support, WordPress configuration and image format.

Thumbnail Dimensions and Cropping

When hard cropping is enabled, WordPress attempts to create the specified dimensions by cropping the source. Without hard cropping, it preserves aspect ratio and fits within the configured bounds.

Cropping can remove important content. Use purpose-specific preparation or focal-point controls when subject placement matters.

Medium and Large Sizes

Medium and large settings normally act as maximum dimensions while preserving aspect ratio.

The size displayed on a page can still depend on the block, theme, template and responsive-image markup.

Changes Are Not Retroactive

Changing Media Settings affects future processing. Existing attachments do not automatically receive new derivatives.

A regeneration process may be required. Before regenerating, create a backup, confirm disk space, review custom sizes, test on staging and understand external storage or CDN synchronization.

Theme and Plugin Image Sizes

Themes and plugins can register sizes that do not appear on this screen, including product thumbnails, card crops and gallery previews.

Do not remove a registered size without understanding where it is used.

Upload Folder Organization

WordPress can organize uploads into year- and month-based folders. This affects physical paths, not the conceptual organization of the Media Library.

Changing the setting affects future uploads. Existing files remain in their previous locations unless migrated.

Upload Limits and File Types

The Media Settings screen does not usually control the maximum upload size or all allowed MIME types. Limits can come from PHP, the web server, hosting rules, Multisite, security plugins and user capabilities.

Choosing Suitable Defaults

  1. Inspect theme content widths.
  2. Review registered sizes.
  3. Identify which sizes templates request.
  4. Check responsive output.
  5. Estimate storage cost.
  6. Test portrait and landscape images.
  7. Document the final configuration.

Frequently Asked Questions

Will changing thumbnail size update old images?

No. Existing derivatives normally require regeneration.

Do Media Settings control every image size?

No. Themes and plugins can register additional sizes.

Does year/month organization create Media Library folders?

No. It changes physical upload paths.

Applying WordPress Media Settings in a Real WordPress Project

Record the current value, the reason for the change and the expected result. Make important configuration changes in a controlled window, test the affected workflows and document settings that another administrator will need to understand.

A connected concept is WordPress Image Sizes and Thumbnails. Reading the two together helps separate the immediate task from the wider WordPress responsibility.

A useful implementation begins by writing down the current state, the intended outcome and the evidence that will prove the change worked. This prevents a configuration screen, plugin recommendation or code snippet from becoming the entire strategy.

A Practical Example

Imagine a team making this decision for a production WordPress site. The useful question is not only “Can WordPress do this?” but “Which layer owns it, who maintains it, what data does it affect and how will we verify it after an update?”

Write the answer in operational terms. Name the content, user, setting, file, API or service involved. Then identify what should remain true if the theme changes, a plugin is replaced or the site is migrated.

Questions to Ask

  • What user or system problem does this solve?
  • Which WordPress layer owns the behaviour?
  • What data is created or changed?
  • Who may perform the action?
  • What can fail, and how will that failure be visible?
  • How is the result tested after updates?
  • What is the migration or removal path?

Follow the Complete Media Lifecycle

A media decision begins with the source file and continues through upload, attachment metadata, generated derivatives, delivery, reuse, replacement and deletion.

Review visual quality, accessibility text, licensing, dimensions, file weight, cache behaviour and every place the asset is referenced. WordPress can track an attachment record, but it cannot always identify every use created by themes, custom fields or external systems.

Official Reference Context

The Plugin Handbook is the primary version-specific reference for this topic. Use the current documentation to verify interface labels, supported APIs and behaviour before applying instructions to a production site.

How to Verify the Result

  • Record the previous setting and the expected change.
  • Test frontend, administration, email, scheduled tasks and affected integrations.
  • Confirm that the configuration is documented for handover and recovery.

Sources and Further Reading

Continue Learning