> For the complete documentation index, see [llms.txt](https://docs.varbase.vardot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.varbase.vardot.com/content-designers/media-management/replace-an-image-everywhere.md).

# Replace an Image Everywhere

A media item is used by reference, so replacing its file changes every page that shows it. Use this to swap an outdated photo, a new logo or a corrected report in one step.

## Steps

1. On the **Media** page, find the item and open it.
2. Check its **Usage** tab for the content that uses it. Images placed on Drupal Canvas pages are not listed there yet, so check those pages too.
3. On the **Edit** tab, click **Remove** on the file, then upload the new one. The form shows the warning "Modifications on this form will affect all existing usages of this entity": that is the point here, so carry on.
4. Check the **Alternative text** and the focal point: they must suit the new picture.
5. Click **Save**. Every page that uses the item shows the new file.

<figure><img src="https://410909369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcuWLZ87gvtX5vA2YGD%2Fuploads%2Fgit-blob-81f883d5a97c4104cc1af0d5f470f55b8b8369e2%2Fmedia-image-01-form.png?alt=media" alt="The Add Image form with an uploaded photo, the focal point cross, the Alternative text field with the Generate with AI button, and the Image description and Image tags fields"><figcaption><p>The Image Form, Where the File Is Replaced</p></figcaption></figure>

{% hint style="info" %}
To use a different image on one page only, do not replace the file. Pick or upload another item on that page instead.
{% endhint %}

## Tips

* Keep the new file the same shape as the old one, so cards and banners do not change size.
* Items with no usage at all are candidates for a clean-up.
