---
title: Image Metadata in Gutenberg Editor
slug: editorial/image-metadata-in-gutenberg-editor
docTags: 
createdAt: 2025-03-27T12:15:50.586Z
---

## Overview

This feature allows editors to view and edit image metadata directly within the Gutenberg editor, eliminating the need to open the media library. The feature displays configured image metadata fields as captions and allows easy editing of image metadata properties.

::loom{url="https://www.loom.com/embed/1f5dbd6fa4e6460d9544ae52b66e974a"}

:::hint{type="warning"}
*Note: This screencast shows a previous version of the interface. The demonstrated workflow is still accurate, but some UI elements may not match the current interface.*
:::



## Setting Up Image Metadata Fields

### Configuration Steps

1. Navigate to Purple Blocks settings
2. Select the Image block settings
3. Look for the new checkbox field: "Meta Fields as Image Caption"
4. Select which metadata fields you want to display:
   - You can add ACF (Advanced Custom Fields) fields
   - You can add Purple fields
   - Common fields include: Title, Owner, Location, and Author
5. Additionally it is possible to activate the "requires caption" and "requires alt text" checkboxes to require caption and alt-text for all image blocks
6. Click "Save" in the popup
7. Remember to click the Purple Blocks "Save" button at the top to apply changes

::Image[]{src="https://api.archbee.com/api/optimize/ffT1XlDSDJpsn08_nTNip-0Flyas3aj4T4wVp6XlwuG-20250715-073701.png" size="78" width="623" height="712" position="center" showCaption="false"}

## Using the Feature in the Editor

### Adding Images with Metadata

When you add an image block in the Gutenberg editor, you'll now see:

1. A notification if required image metadata is missing
2. When hovering over the image, you'll see which fields need to be filled

![](https://api.archbee.com/api/optimize/rT3F8jdvUrvCkGVKB9hjO-7iPw5CGRzXYGjQLkzH8kc-20250528-123615.png)

### Editing Image Metadata

Image metadata can be:

### 1. Using the Sidebar (Recommended)

- Select the image block
- Find the sidebar panel on the right side
- Click on "open in media library"
- The Image Editor will open showing metadata fields
- Fill in the required fields
- These changes apply to the current article by default

### 2. Using Image Editor

- Click the pen icon on the image
- The Image Editor will open showing metadata fields
- Fill in the required fields
- These changes apply to the current article by default

::Image[]{src="https://api.archbee.com/api/optimize/rT3F8jdvUrvCkGVKB9hjO-w5MGTYde9tOObCcyjmnXI-20250528-124237.png" size="62" width="406" height="160" position="center" showCaption="false"}

### Saving Metadata Changes

You have two saving options:

1. **For this article only**: Simply save the post/article (default behavior)
2. **In the media library (global change)**: Click "Save image data to Media Library" button

After saving, the configured metadata will appear as a caption below the image.

:::hint{type="warning"}
**Important Note**: When you upload an image and edit its metadata in the sidebar or editor, those changes apply only to the current article. If you want these changes to persist in the Media Library for use in other articles, you must click the "Save image data to Media Library" button.
:::

## Additional Capabilities

### Caption and Alt Text Editing

In addition to metadata fields, you can now directly edit:

1. **Caption**: The text displayed below the image
2. **Alt Text**: The text used for accessibility and SEO purposes

These fields are visible in both the sidebar panel and the Image Data section of the image editor.

## Common Questions

**Q: I set caption/alt text in the Media Library, but they're not appearing when I add the image to my article. Why?**
A: After uploading an image to an article, you need to set the caption/alt text in the sidebar panel for that specific article.

**Q: I've changed the caption in one article, but it's not showing in my other articles. Why?**
A: By default, caption and alt text changes are specific to each article. To make these changes global, update the changes in the media library button.

## Benefits

- View image metadata directly in the Gutenberg editor
- Edit metadata without having to open the media library
- Save time on image management workflows
- Ensure all required metadata is present before publishing
- Option to make changes locally or globally

## Support

If you have questions or need assistance with the Image Metadata features, please contact the support team.