Administration panel

Page summary:

The admin panel acts as Strapi’s back office for managing content types, entries, and both administrator and end‑user accounts. This documentation gives an overview of the admin panel. It then covers profile settings (interface language and mode, login and personal information) and settings (logo for branding, password policy for administrator accounts).

The admin panel is the back office of your Strapi application. From the admin panel, you will be able to manage content-types and write their actual content, but also manage users, both administrators and end users of your Strapi application.

Tip

You can create your own widgets to customize the admin panel's homepage.

You can also customize the layout (widget controls appear when you hover over a widget or between widgets):

• Resize: Drag the divider in a two-widget row left or right.
• Reorder: Drag the button to move a widget.
• Delete: Click the button.
• Restore: Use the "Add widget" button at the top of the page to bring back a deleted widget.

Overview

Prerequisites

There are a few factors that you should keep in mind when using the admin panel, as they could modify the interface and your experience with it.

• Development, Staging or Production Environment
  Your content structure and application configuration change status: from development environment to production or staging environment once deployed. Some features are only available in development. Check the Identity Cards to know when features are usable.

• License and Pricing Plans
  Some features's availability or limits depend on whether your application is using the free Community Edition, the Growth plan, or the Enterprise plan. Look for the GrowthThis feature is available with a Growth plan. and EnterpriseThis feature is available with an Enterprise plan. badges in the docs.

• Roles and Permissions
  Some features and the content itself are ruled by a system of permissions that can be defined at a detailed level. Depending on your role and permissions, you may not be able to access all the features and options. Read the RBAC feature documentation for more information.

• Future flags
  Some incoming Strapi features are not yet ready to be shipped to all users, but Strapi still offers community users the opportunity to provide early feedback. These experimental features require enabling the corresponding future flags. Look for the Feature FlagThis feature requires a feature flag to be enabled. badge in the docs and read the Feature flags documentation for more information.

Configuration

Path to configure the admin panel: Account name or initials (bottom left hand corner) > Profile

If you are a new administrator, we recommend making sure your profile is all set, before diving into your Strapi application. From your administrator profile, you are able to modify your user information (name, username, email, password). You can also choose the language and mode of the interface for your Strapi application. From the settings, administrators with the "Read the password policy" and "Update the password policy" permissions can also define the password policy that applies to all administrator passwords.

There are many more configuration and customization options available. See the following pages for more details:

Code-based configuration

Configure the appearance, security, and features of the Strapi admin panel via the /config/admin file.

Customization

Match your branding, replace the WYSIWYG editor, configure the bundler, extend features, and more.

Modifying profile information (name, email, username)

1. Go to the Profile section of your profile.
2. Fill in the following options:

Profile & Experience	Instructions
First name	Write your first name in the textbox.
Last name	Write your last name in the textbox.
Email	Write your complete email address in the textbox.
Username	(optional) Write a username in the textbox.

3. Click on the Save button.

Changing account password

1. Go to the Change password section of your profile.
2. Fill in the following options:

Password modification	Instructions
Current password	Write your current password in the textbox.
Password	Write the new password in the textbox. It must follow the password policy, whose rules are displayed under the field.
Password confirmation	Write the same new password in the textbox.

3. Click on the Save button.

Tip

You can click on the icon for the passwords to be shown.

Choosing interface language

In the Experience section of your profile, select your preferred language using the Interface language dropdown.

Note

Keep in mind that choosing an interface language only applies to your account on the admin panel. Other users of the same application's admin panel can use a different language.

Choosing interface mode (light, dark)

By default, the chosen interface mode is based on your browser's mode. You can however, in the Experience section of your profile, manually choose either the Light Mode or Dark Mode using the Interface mode dropdown.

Note

Keep in mind that choosing an interface mode only applies to your account on the admin panel.

Resetting guided tour

In the Guided tour section of your profile, you can click the Reset guided tour button to reset the guided tour which is available in the homepage of the admin panel. It allows you to see again the guided tour of the admin panel if you closed it beforehand, and to follow again its various steps.

Customizing the logo

Path to configure the admin panel: Settings > Global settings > Overview

The default Strapi logos, displayed in the main navigation of a Strapi application and the authentication pages, can be modified.

1. Click on the upload area for Menu logo or Auth logo.
2. 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.
3. Click on the Upload logo button in the upload window.
4. Click on the Save button in the top right corner.

Once uploaded, the new logo can be replaced with another one , or reset with the default Strapi logo or the logo set in the configuration files.

Note

Both logos can also be customized programmatically via the Strapi application's configuration files (see Admin panel customization). However, the logos uploaded via the admin panel supersedes any logo set through the configuration files.

Configuring the password policy

Path to configure the password policy: Settings > Administration panel > Password policy

The password policy defines the rules that every administrator password must follow. End users of the Users & Permissions feature are managed separately and do not follow this policy.

Viewing the policy requires the "Read the password policy" permission, and editing it requires the "Update the password policy" permission (see RBAC). With the read permission only, the options are displayed but cannot be edited, and the Save button is not displayed.

The rules apply whenever an administrator password is set or changed:

• when registering,
• when resetting a forgotten password,
• when changing your own password from your profile (see Changing account password),
• when editing another administrator account (see RBAC),
• when using the admin:create-user and admin:reset-user-password CLI commands.

Existing passwords stay valid until they are changed.

To configure the password policy:

1. Fill in the following options:

Option	Instructions	Default value
Minimum length	Write the minimum number of characters for a password, between 8 and 64. Whatever the policy, a password cannot exceed 72 bytes.	8
Require a lowercase letter	Choose whether a password must contain at least one lowercase letter.	True
Require an uppercase letter	Choose whether a password must contain at least one uppercase letter.	True
Require a number	Choose whether a password must contain at least one number.	True
Require a special character	Choose whether a password must contain at least one special character, meaning any character that is neither a letter nor a digit.	False

2. Check the Hint shown to users preview. It displays the rules as administrators will read them under password fields.
3. Click on the Save button.

Usage

Caution

In order to access the admin panel, your Strapi application must be launched, and you must be aware of the URL to its admin panel (e.g. api.example.com/admin).

To access the admin panel:

1. Go to the URL of your Strapi application's admin panel.
2. Enter your credentials to log in.
3. Click on the Login button. You should be redirected to the homepage of the admin panel.

Note

If you prefer or are required to log in via an SSO provider, please refer to the Single Sign-On documentation.