Skip to content

Fix plugins extension page #3000

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
pwizla merged 1 commit into from
Mar 11, 2026
Merged

Fix plugins extension page #3000

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 12 additions & 6 deletions docusaurus/docs/cms/plugins-development/plugins-extension.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,9 +37,9 @@ Plugin extensions code is located in the `./src/extensions` folder (see [project
strapi-server.js|ts
/content-types
/some-content-type-to-extend
model.json
schema.json
/another-content-type-to-extend
model.json
schema.json
/another-plugin-to-extend
strapi-server.js|ts
```
Expand All @@ -58,7 +58,7 @@ The final schema of the content-types depends on the following loading order:

1. the content-types of the original plugin,
2. the content-types overridden by the declarations in the [schema](/cms/backend-customization/models#model-schema) defined in `./src/extensions/plugin-name/content-types/content-type-name/schema.json`
3. the content-types declarations in the [`content-types` key exported from `strapi-server.js|ts`](/cms/plugins-development/server-content-types)
3. the content-types declarations in the [`contentTypes` export from `strapi-server.js|ts`](/cms/plugins-development/server-content-types)
4. the content-types declarations in the [`register()` function](/cms/configurations/functions#register) of the Strapi application

To overwrite a plugin's [content-types](/cms/backend-customization/models):
Expand Down Expand Up @@ -123,9 +123,9 @@ The `strapi-server.js|ts` file is also where you can override the image function
```js title="./src/extensions/upload/strapi-server.js|ts"

module.exports = (plugin) => {
plugin.services.upload.image.generateFileName = (file) => {
// Example: prefix a timestamp before the original name
return `${Date.now()}_${file.hash}${file.ext}`;
plugin.services['image-manipulation'].generateFileName = (file) => {
// Example: prefix a timestamp before the generated base name
return `${Date.now()}_${name}`;
};

return plugin;
Expand All @@ -136,6 +136,12 @@ module.exports = (plugin) => {

:::

`generateFileName()` belongs to the Upload plugin's `image-manipulation` service and expects a single `name: string` argument.

:::caution
This customization relies on an internal Upload plugin service (`image-manipulation`). Internal extension points are not part of Strapi's stable public API and can change between versions.
:::

### Within the register and bootstrap functions

To extend a plugin's interface within `./src/index.js|ts`, use the `bootstrap()` and `register()` [functions](/cms/configurations/functions) of the whole project, and access the interface programmatically with [getters](/cms/plugins-development/server-getters-usage).
Expand Down
Loading