Media Prefix logo

Media Prefix

By Imran Baali

Strapi Media Prefix Plugin allows you to prepend a custom public URL or media prefix to media assets such as images, files, and audio in Strapi Admin Panel and API responses, without modifying the original relative paths stored in the database.

Latest version

v1.0.6

released August 25, 2025

npm install strapi-plugin-media-prefix

strapi media prefix plugin Logo

Strapi Media Prefix Plugin

Prepend media urls (images, files, audios, ) with your public url/media prefix on both Admin Panel and API's just in response without changing the relative path in database

Prepend media url Screenshot

⚙️ Installation

npm install strapi-plugin-media-prefix
# or
yarn add strapi-plugin-media-prefix

✒️ Plugin Configuration

Enable the plugin by adding the following lines of code in the file: ./config/plugins.ts

// ./config/plugins.ts
export default () => ({
  "media-prefix": {
    enabled: true,
  },
});

or in the file: ./config/plugins.js

// ./config/plugins.js
module.exports = {
  'media-prefix': {
    enabled: true,
  },
};

🌐 Environment Configuration

The plugin can get the public url/media prefix from the .env file or from the server config file: ./config/server.ts if you don't define the MEDIA_PREFIX key in the .env file

🔧 Using .env file for environment configuration

The plugin get the public url/media prefix from .env file using the key MEDIA_PREFIX

so be sure to add MEDIA_PREFIX key in the .env file

#.env
MEDIA_PREFIX=https://kirwako.com/media

🚀 Using ./config/server.ts file for environment configuration

The plugin can also get the public url/media prefix from the server config file: ./config/server.ts if you don't define the MEDIA_PREFIX key in the .env file

so be sure to add url key in the server config file

in the file: ./config/server.ts

// ./config/server.ts
export default ({ env }) => ({
  host: env('HOST', '0.0.0.0'),
  port: env.int('PORT', 1337),
  app: {
    keys: env.array('APP_KEYS'),
  },
  url: env('PUBLIC_URL', 'http://localhost:1337'), // be sure to add this line
});

or in the file: ./config/server.js

// ./config/server.js
module.exports = ({ env }) => ({
  host: env('HOST', '0.0.0.0'),
  port: env.int('PORT', 1337),
  app: {
	keys: env.array('APP_KEYS'),
  },
  url: env('PUBLIC_URL', 'http://localhost:1337'), // be sure to add this line
});

Support

I am very Happy 😀 about every coffee!

Buy Me A Coffee

Submit your content

Share your work with the community and get it listed in the Strapi ecosystem for everyone to discover and use.

Submit
Submit your content