---
title: 'Admin Media Replace Plugin'
url: 'https://www.twelvetone.tv/docs/developer-tools/grav-plugins/admin-media-replace-plugin'
markdown: 'https://www.twelvetone.tv/docs/developer-tools/grav-plugins/admin-media-replace-plugin.md'
date: '2026-09-25'
description: "Replaces media in your page's media bin. Featur"
taxonomy:
  category:
    - docs
  devtype:
    - mit
---

[](#)  [ Home ](https://www.twelvetone.tv/docs/)     [ Developer Tools ](https://www.twelvetone.tv/docs/developer-tools)     [ Grav Plugins ](https://www.twelvetone.tv/docs/developer-tools/grav-plugins)      Admin Media Replace Plugin    

This product is in active development and has been released under the [MIT license](https://opensource.org/licenses/MIT).

Replaces media in your page's media bin.

# Features

- Upload new media without having to delete the old media first.
- The uploaded file will be renamed to match the original. Page links will not break.
- Admin media thumbnail will refresh without reloading the page. 
    # Usage
- This plugin will add a new action to items in your media bin.
- Selecting the action will open a file picker or upload dialog (depending on the plugin option *quicksave*.
- The selected file will be uploaded and will replace your current page.
- The original filename will be used, so current links will not break. ![](https://www.twelvetone.tv/docs/user/pages/03.developer-tools/06.grav-plugins/08.admin-media-replace-plugin/media_action.png)![](https://www.twelvetone.tv/docs/user/pages/03.developer-tools/06.grav-plugins/08.admin-media-replace-plugin/dialog.png)

# Options

Rename FileRenames the uploaded file to match the source file.Match ExtensionOnly replace media if the MIME type is the sameRequire ImageOnly accept the uploaded file if it is a valid image.# Issues

- Any file type and size can be uploaded by default, so BEWARE.
- When name does not change, there may be caching delays links to the original source.
- No uploading progress indicator.

 [ ](https://www.twelvetone.tv/docs/developer-tools/grav-plugins/grav-admin-media-move-plugin) [](https://www.twelvetone.tv/docs/developer-tools/grav-plugins/grav-bulk-edit-plugin)

---

## Navigation

- Parent: [Grav Plugins](https://www.twelvetone.tv/docs/developer-tools/grav-plugins.md)
- Previous: [Grav Admin Media Move Plugin](https://www.twelvetone.tv/docs/developer-tools/grav-plugins/grav-admin-media-move-plugin.md)
- Next: [Grav Bulk Edit Plugin](https://www.twelvetone.tv/docs/developer-tools/grav-plugins/grav-bulk-edit-plugin.md)