diff --git a/docs/developer-docs/latest/plugins/email.md b/docs/developer-docs/latest/plugins/email.md
index 4238b8a71b..9885fe6347 100644
--- a/docs/developer-docs/latest/plugins/email.md
+++ b/docs/developer-docs/latest/plugins/email.md
@@ -100,8 +100,8 @@ yarn add @strapi/provider-email-sendgrid --save
 
 After installing your provider you will need to add some settings in `./config/plugins.js`. If this file doesn't exists, you'll need to create it. Check the README of each provider to know what configuration settings the provider needs.
 
-::: tip
-Make sure you have the correct spelling of the configuration filename, it is written in plural (with a trailing 's'): `plugins.js`.
+::: note
+When using community providers, pass the full package name to the `provider` key (e.g. `provider: 'strapi-provider-email-mandrill'`). Only Strapi-maintained providers can use the shortcode format (e.g. `provider: 'sendmail'`).
 :::
 
 Here is an example of a configuration made for the provider [@strapi/provider-email-sendgrid](https://www.npmjs.com/package/@strapi/provider-email-sendgrid).
@@ -155,17 +155,6 @@ module.exports = {
 };
 ```
 
-It is important that your provider's `package.json` includes the following object:
-
-```json
-{
-  // ...
-  "strapi": {
-    "isProvider": true
-  }
-}
-```
-
 In the `send` function you will have access to:
 
 - `providerOptions` that contains configurations written in `plugins.js`
diff --git a/docs/developer-docs/latest/plugins/upload.md b/docs/developer-docs/latest/plugins/upload.md
index 7f6e7b4509..d12990bd94 100644
--- a/docs/developer-docs/latest/plugins/upload.md
+++ b/docs/developer-docs/latest/plugins/upload.md
@@ -406,8 +406,8 @@ module.exports = ({ env })=>({
 
 To enable the provider, create or edit the file at `./config/plugins.js`
 
-:::tip
-When using community providers, you need to pass the full package name to the `provider` key, only Strapi maintained providers can use the short-code eg: `provider: 'strapi-provider-upload-google-cloud-storage'`
+::: note
+When using community providers, pass the full package name to the `provider` key (e.g. `provider: 'strapi-provider-upload-google-cloud-storage'`). Only Strapi-maintained providers can use the shortcode format (e.g. `provider: 'aws-s3'`).
 :::
 
 ```js