Documentation Commerce Configuration Reference

Advanced > Admin

Last update: Wed May 07 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

Beginner
Intermediate
Admin

To access the store configuration settings, choose Stores > Settings > Configuration from the Admin sidebar.

Admin User Emails

For more information about changing these settings, see Forgotten password and reset email.

Field

Scope

Description

Forgot Password Email Template

Global

Identifies the email template that is used for the message that is sent when an Admin user forgets their password. Default template: Forgot Admin Password

Forgot and Reset Email Sender

Global

Identifies the store contact that appears as the sender of the Forgot Password email. Default sender: General Contact
Other sender options: Sales Representative, Customer Support, Custom Email

User Notification Template

Global

Determines the email template that is used as the default for Admin notifications. Default template: User Notification

Startup Page

For more information about changing these settings, see Change the startup page in the Getting Started Guide.

Field

Scope

Description

Startup Page

Global

Determines the Admin landing page that appears after you log in.

Startup Page options

Area

Option

Dashboard

Sales

Operations

Quotes

Orders
Invoices
Shipments
Credit Memos
Billing Agreements
Returns

Transactions
Braintree Virtual Terminal

Catalog

Inventory

Products
Categories
Shared Catalog

Customers

All Customers
Now Online
Customer Groups
Segments

Companies

Marketing

Promotions

Catalog Price Rule
Cart Price Rules)
Related Products Rules

Gift Card Accounts

Private Sales

Events
Invitations

Communications

Email Templates
Newsletter Template
Newsletter Queue
Newsletter Subscribers
Email Reminders

SEO & Search

Search Terms
Search Synonyms

URL Rewrites
Site Map

User Content

All Reviews
Pending Reviews

Content

Elements

Pages
Hierarchy

Blocks
Dynamic Blocks

Widgets
Media Gallery

Design

Configuration
Themes
Schedule

Content Staging

Dashboard

Reports

Marketing

Products in Cart
Search Terms
Abandoned Carts
Newsletter Problem Reports

Reviews

By Customer
By Products

Sales

Orders
Tax
Invoiced
Shipping
Refunds
Coupons
PayPal Settlement
Braintree Settlement

System Insights

Site-Wide Analysis Tool

Customers

Order Total
Order Count
New
Wish Lists
Segments

Products

Views
Bestsellers
Low Stock
Ordered
Downloads

Private Sales

Invitations
Invited Customers
Conversions

Statistics

Refresh Statistics

Business Intelligence

Advanced Reporting
BI Essentials

Customer Engagement

Dashboard
Importer Status
Automation Enrollment
Campaign Sends
SMS Sends
Cron Tasks
Log Viewer
Abandoned Carts

Stores

Settings

All Stores
Configuration
Terms and Conditions
Order Status

Inventory

Sources
Stocks

Taxes

Tax Rules
Tax Zones and Rates

Currency

Currency Rates
Currency Symbols

Attributes

Customer
Customer Address
Product
Attribute Set
Returns
Ratings

Other Settings

Reward Exchange Rates
Gift Wrapping
Gift Registry

System

Data Transfer

Import
Export
Import/Export Tax Rates
Import History
Scheduled Import/Export

Extensions

Integrations

Tools

Cache Management
Index Management

Support

System Report

Permissions

All Users
Locked Users
User Roles

Action Log

Report
Archive
Bulk Actions

Other Settings

Notifications
Custom Variables
Manage Encryption Key

Find Partners & Extensions

Admin Base URL

For more information about setting these options, see Configure the base URL in the Stores and Purchase Experience Guide.

Field

Scope

Description

Use Custom Admin URL

Global

Determines if a custom URL is used to access the Admin. Options: Yes / No

Custom Admin URL

Global

Specifies a custom URL to access the Admin. By default, the Admin URL is the same as the base URL.
Important: The Admin URL must be in the same Commerce installation, and have the same document root as the storefront.

Use Custom Admin Path

Global

Determines if a custom path is used to access the Admin. The default path is admin. Options: Yes / No

Custom Admin Path

Global

Changes the name of the default Admin path to something hard to guess. Enter the custom path name in lowercase characters. For example: aardvark

Security

For more information about setting these options, see Configure Admin security in the Admin Systems Guide.

Field

Scope

Description

Admin Account Sharing

Store View

Determines if an Admin user can be logged in to the same account simultaneously from different devices. Options:
Yes - Allows multiple active sessions from the same Admin account.
No - Allows only one active session per Admin account.

Password Reset Protection Type

Store View

Determines the method that is used to manage password reset requests. Options:
By IP and Email - The password can be reset online after a response is received from the notification is sent to the email address associated with the Admin account.
By IP - The password can be reset online without additional confirmation.
By Email - The password can be reset only by responding by email to the notification that is sent to the email address associated with the Admin account.
None - The password can be reset only by the store administrator.

Recovery Link Expiration Period (hours)

Global

Determines the number of hours a password recovery link remains valid.

Max Number of Password Reset Requests

Store View

Determines the maximum number of password requests that can be submitted per hour.

Min Time Between Password Reset Requests

Store View

Determines the minimum number of minutes between password reset requests.

Add Secret Key to URLs

Global

When enabled, appends a secret key to the Admin URL as a precaution against exploits. Options: Yes / No

Global

Determines if login credentials entered by a user must match the case of the ones stored. Options: Yes / No

Admin Session Lifetime (seconds)

Global

Determines the length of an Admin session in seconds.

Maximum Login Failures to Lockout Account

Global

Determines the number of times Admin users can try to log in before their accounts are locked. If the field is empty, no minimum is set. Default value: 6

Lockout Time (minutes)

Global

Determines the number of minutes an Admin account is locked before the user can try to log in again. Default value: 30

Password Lifetime (days)

Global

Determines the number of days before an Admin password expires. If the field is empty, no lifetime is set. Default value: 90

Password Change

Global

Determines if Admin users are required to change their passwords. Options:
Forced - Requires that Admin users change their passwords after the account is set up.
Recommended - Recommends that Admin users change their passwords after the account is set up.

Dashboard

For more information about setting these options, see Admin dashboard in the Getting Started Guide.

Field

Scope

Description

Enable Charts

Global

Determines if the dashboard includes a chart generated from current sales data. Options: Yes / No

Admin Grids

For more information about setting these options, see Limit product display in the Catalog Management Guide.

NOTE

To improve performance for large catalogs, it is recommended that you limit the number of products displayed in the grid.

Field

Scope

Description

Limit Number of Products in Grid

Global

Determines if the number of products displayed the grid is limited to the Records Limit value. Options: Yes / No

Records Limit

Global

Sets the number limit of products in the product grid. The default minimum value is 20000.

CAPTCHA

For more information about setting these options, see CAPTCHA in the Admin Systems Guide.

Field

Scope

Description

Enable CAPTCHA in Admin

Global

Enables CAPTCHA for the Admin login. Options: Yes / No

Font

Global

Determines the font that is used to display the CAPTCHA. To add your own font, put the font file in the same directory as your Commerce instance, and add the declaration to the config.xml file at app/code/Magento/Captcha/etc Default font: LinLibertine

Forms

Global

Determines the forms where CAPTCHA is used. Options: Admin Login / Admin Forgot Password

Displaying Mode

Global

Determines when the CAPTCHA appears. Options:
Always - CAPTCHA is always required to log in.
After number of attempts to login - Displays the Number of Unsuccessful Attempts to Login field. Enter the number of login attempts allowed. A value of 0 (zero) is similar to setting Displaying Mode to Always. This option does not cover the Forgot Password and Create User forms. If CAPTCHA is enabled and set to appear, it is always included on the form.
Note: To track the number of unsuccessful login attempts, each attempt to log in under one email address and from one IP-address is counted. The maximum number of login attempts allowed from the same IP-address is 1,000. This limitation applies only when CAPTCHA is enabled.

Number of Unsuccessful Attempts to Login

Global

Determines the number of times a person can try to login before the account is locked. To track the number of unsuccessful login attempts, the system tracks the attempts from one email address from a single IP-address. The maximum number of attempts allowed from the same IP address is 1,000. This limitation applies only if CAPTCHA is enabled.

CAPTCHA Timeout (minutes)

Global

Determines the lifetime of the current CAPTCHA. When the CAPTCHA expires, the user must reload the page.

Number of Symbols

Global

Determines the number of symbols that are used in the CAPTCHA. The maximum allowed value is 8. You can also specify a range, for example, 5-8.

Symbols Used in CAPTCHA

Global

Determines which symbols are used in the CAPTCHA. Only letters (a-z and A-Z) and numbers (0-9) are allowed. The default set of symbols suggested in the field excludes similar-looking symbols like i, l, or 1. Displaying these symbols in CAPTCHA decreases the chances that a user recognizes CAPTCHA correctly.

Case Sensitive

Global

Determines if the characters used in the CAPTCHA are case-sensitive. Options: Yes / No

Admin Actions Logging

{width="20"} Exclusive feature only in Adobe Commerce (Learn more)

Admin Actions Logging

For more information about setting these options, see Action log archive in the Admin Systems Guide.

Field

Scope

Description

Enable Actions

Global

Enables action logging for each of the selected actions:
Admin My Account
Admin Permission Roles
Admin Permission Users
Admin Sign In
CMS Blocks
CMS Hierarchy
CMS Pages
Cache Management
Cart Price Rules
Catalog Attributes
Catalog Categories
Catalog Events
Catalog Price Rules
Catalog Product Tax Classes
Catalog Product Templates
Catalog Products
Catalog Ratings
Catalog Reviews
Catalog Search
Checkout Terms and Conditions
Companies
Company Credit
Custom Variables
Customer Groups
Customer Invitations
Customer Tax Classes
Customers
Design Configuration
Gift Card Accounts
Gift Registry Entity
Gift Registry Type
Index Management
Login as a Customer
Manage Currency Rates
Manage Customer Address Attributes
Manage Customer Attributes
Manage Design
Manage Dynamic Blocks
Manage Segments
Manage Store Views
Manage Stores
Manage Websites
Negotiable Quotes
Newsletter Queue
Newsletter Subscribers
Newsletter Templates
PayPal Settlement Reports
Reports
Reward Points Rates
Rule-Based Product Relations
Sales Archive
Sales Credit Memos
Sales Invoices
Sales Order Status
Sales Orders
Sales Shipments
Shared Catalog
Shopping Cart Management
Store Credit
System Backups
System Configuration
Tax Rates
Tax Rules
Transactional Emails
URL Rewrites
Widget
XML Sitemap

Admin Usage

For more information about setting these options, see Usage data collection in the Getting Started Guide.

Field

Scope

Description

Enable Admin Usage Tracking

Global

Grants permission for Adobe to collect Admin usage data to improve the experience of using the Admin, and related products and services. Allowing data collection also enables In-Product Guidance which is designed to bring interactive content such as help, tool tips, walk-through guides, onboarding information, feature announcements, and more to the Admin. Individual administrators are not identified in usage data. Options:
Yes - Allows data collection and enables In-Product Guidance.
No - Does not allow data collection nor enable In-Product Guidance.

recommendation-more-help

d39aca6f-58a0-41c6-83eb-39fd0ef30672