Plugins configuration

Page summary:
/config/plugins enables or disables plugins and overrides their settings, with examples for local plugin development.

Plugin configurations are stored in /config/plugins.js|ts (see project structure). Each plugin can be configured with the following available parameters:

Parameter	Description	Type
`enabled`	Enable (`true`) or disable (`false`) an installed plugin	Boolean
`config` Optional	Used to override default plugin configuration (defined in strapi-server.js)	Object
`resolve` Optional, only required for local plugins	Path to the plugin's folder	String

Note

Some features of Strapi are provided by plugins and the following plugins can also have specific configuration options: the GraphQL plugin, the Upload package which powers the Media Library, and Users & Permissions.

Basic example custom configuration for plugins:

JavaScript
TypeScript

./config/plugins.js

module.exports = ({ env }) => ({
  // enable a plugin that doesn't require any configuration
  i18n: true,

  // enable a custom plugin
  myplugin: {
    // my-plugin is going to be the internal name used for this plugin
    enabled: true,
    resolve: './src/plugins/my-local-plugin',
    config: {
      // user plugin config goes here
    },
  },

  // disable a plugin
  'my-other-plugin': {
    enabled: false, // plugin installed but disabled
  },
});

./config/plugins.ts

export default ({ env }) => ({
  // enable a plugin that doesn't require any configuration
  i18n: true,

  // enable a custom plugin
  myplugin: {
    // my-plugin is going to be the internal name used for this plugin
    enabled: true,
    resolve: './src/plugins/my-local-plugin',
    config: {
      // user plugin config goes here
    },
  },

  // disable a plugin
  'my-other-plugin': {
    enabled: false, // plugin installed but disabled
  },
});

Tip

If no specific configuration is required, a plugin can also be declared with the shorthand syntax 'plugin-name': true.