diff --git a/docs/developer-docs/latest/development/admin-customization.md b/docs/developer-docs/latest/development/admin-customization.md index 3eac86cddc..916c6769de 100644 --- a/docs/developer-docs/latest/development/admin-customization.md +++ b/docs/developer-docs/latest/development/admin-customization.md @@ -217,9 +217,13 @@ The Strapi admin panel displays a logo in 2 different locations, represented by | On the login page | `config.auth.logo` | | In the main navigation | `config.menu.logo` | -To update the logos, put image files in the `./src/admin/extensions` folder and update the corresponding keys. +To update the logos, put image files in the `./src/admin/extensions` folder and update the corresponding keys. There is no size limit for image files set through the configuration files. -The size of the custom image should be the same as the default one (434px x 120px). +::: note +The logo displayed in the main navigation of the admin panel can also be customized directly via the admin panel (see [User Guide](/user-docs/latest/settings/managing-global-settings.md)). However, the logo displayed in the login page can only be customized via the configuration files for now. +
+Note also that the main navigation logo uploaded via the admin panel supersedes any logo set through the configuration files. +::: #### Favicon diff --git a/docs/user-docs/latest/assets/icons/add.svg b/docs/user-docs/latest/assets/icons/add.svg new file mode 100644 index 0000000000..fe47437511 --- /dev/null +++ b/docs/user-docs/latest/assets/icons/add.svg @@ -0,0 +1,3 @@ + + + diff --git a/docs/user-docs/latest/assets/icons/reset_icon.svg b/docs/user-docs/latest/assets/icons/reset_icon.svg new file mode 100644 index 0000000000..41188f3038 --- /dev/null +++ b/docs/user-docs/latest/assets/icons/reset_icon.svg @@ -0,0 +1,3 @@ + + + diff --git a/docs/user-docs/latest/assets/settings/settings_custom-logo.png b/docs/user-docs/latest/assets/settings/settings_custom-logo.png new file mode 100644 index 0000000000..132897ad10 Binary files /dev/null and b/docs/user-docs/latest/assets/settings/settings_custom-logo.png differ diff --git a/docs/user-docs/latest/settings/managing-global-settings.md b/docs/user-docs/latest/settings/managing-global-settings.md index c9c5e1ba1e..8937815ab3 100644 --- a/docs/user-docs/latest/settings/managing-global-settings.md +++ b/docs/user-docs/latest/settings/managing-global-settings.md @@ -8,6 +8,30 @@ canonicalUrl: https://docs.strapi.io/user-docs/latest/settings/managing-global-s Global settings for plugins and features are managed from ![Settings icon](../assets/icons/settings.svg) *Settings* in the main navigation of the admin panel. +## Customizing the admin panel + +The default Strapi logo, displayed in the main navigation of a Strapi application, can be modified through the *Settings > Overview* sub-section of the admin panel. + +::: note +The logo displayed in the admin panel can also be customized programmatically via the Strapi application's configuration files (see [Developer Documentation](/developer-docs/latest/development/admin-customization.md#logos)). However, the logo uploaded via the admin panel supersedes any logo set through the configuration files. +
+Note also that modifying the configuration files (see [Developer Documentation](/developer-docs/latest/development/admin-customization.md#configuration-options)) also allows changing the logo displayed in the login page of the application, which is not yet possible via the *Settings* section of the admin panel. +::: + +![Custom logo settings](../assets/settings/settings_custom-logo.png) + +To customize the logo of the admin panel: + +1. Go to the *Global settings > Overview* sub-section of the settings interface. +2. Click on the upload area. +3. Upload your chosen logo, either by browsing files, drag & dropping the file in the right area, or by using a URL. The logo shouldn't be more than 750x750px. +4. Click on the **Upload logo** button in the upload window. +5. Click on the **Save** button in the top right corner. + +::: tip +Once uploaded, the new logo can be replaced with another one ![Add icon](../assets/icons/add.svg), or resetted ![Reset icon](../assets/icons/reset_icon.svg) with the default Strapi logo or the logo set in the configuration files. +::: + ## Configuring Single Sign-On Single Sign-On (SSO) can be made available on a Strapi application to allow administrators to authenticate through an identity provider (e.g. Microsoft Azure Active Directory).