Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
8 changes: 6 additions & 2 deletions docs/developer-docs/latest/development/admin-customization.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
<br>
Note also that the main navigation logo uploaded via the admin panel supersedes any logo set through the configuration files.
:::

#### Favicon

Expand Down
3 changes: 3 additions & 0 deletions docs/user-docs/latest/assets/icons/add.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 3 additions & 0 deletions docs/user-docs/latest/assets/icons/reset_icon.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
24 changes: 24 additions & 0 deletions docs/user-docs/latest/settings/managing-global-settings.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
<br>
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 <GoldBadge withLinkIcon link="https://strapi.io/pricing-self-hosted" />

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).
Expand Down