DocumentationContent and Design

[PaaS only]{class="badge informative" title="Applies to Adobe Commerce on Cloud projects (Adobe-managed PaaS infrastructure) and on-premises projects only."}

The Media Gallery

Last update: November 3, 2026

CREATED FOR:

  • Intermediate
  • Beginner
  • User
  • Admin

Merchants can use the Media Gallery to organize and manage their media files on the server.

Images displayed in the Media Gallery grid {width="700" modal="regular"}

NOTE
Product images added to the Images and Videos product section are not managed by the Media Gallery. Only images used in the Content product section fields are displayed and filtered in the new Media Gallery.

  1. On the Admin sidebar, go to Stores > Settings > Configuration.

  2. In the left panel, expand Advanced and choose System.

  3. Expand Expansion selector Media Gallery.

    Advanced configuration - Media Gallery {width="600" modal="regular"}

  4. Verify that Enable Old Media Gallery is set to No.

    note important
    IMPORTANT
    The option to enable the Old Media Gallery is deprecated. Ensure that this setting is always set to No.

  5. Click Save Config.

  6. When prompted, click the Cache Management link in the system message and refresh the invalid cache.

    The Content menu now displays the new Media Gallery option.

NOTE
Full functionality for new Media Gallery requires media.gallery.synchronization and media.content.synchronization queue consumers to be started for initial synchronization. See Manage message queues in the Configuration Guide for more details.

The new Media Gallery is accessible from the Content menu or when you add or edit a page. You can also access it when you create or edit a category, or when you insert images using the Content Editor.

To access the new Media Gallery through the Content menu:

  • On the Admin sidebar, go to Content > Media > Media Gallery.

To access the new Media Gallery when you are adding or editing a page:

  1. On the Admin sidebar, go to Content > Elements > Pages.

  2. Click Add a New Page.

    If you want to edit an existing page, you can use the Action column to click Select and choose Edit.

  3. Expand Expansion selector the Content section and do the following:

    • If you have Page Builder enabled, expand the Media panel and drag an Image placeholder to the target container. Then click Select from Gallery.

      Drag image to stage {width="600" modal="regular"}

    • If you have the WYSIWYG editor enabled, click Show/Hide Editor and then click Insert Image.

To learn more about the Media Gallery, watch this video:

https://video.tv.adobe.com/v/343785?quality=12&learn=on
recommendation-more-help
commerce-admin-help-content-design