banner-4
Adobe Summit is here.
Experience keynotes, Sneaks, sessions, and more — all on demand.
Watch now
DocumentationCommerceConfiguration Reference

Advanced > System

October 31, 2024
  • Topics:
  • Configuration
  • System

CREATED FOR:

  • Beginner
  • Intermediate
  • Admin
  • Developer

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

Cron (Scheduled Tasks)

Advanced configuration - Cron (Scheduled Tasks)

For more information about changing these configuration settings, see Cron (scheduled tasks).

index

Advanced configuration - Cron Group: Index

Field
Scope
Description
Generate Schedules Every
Global
Determines the frequency in minutes, that schedules are generated.
Schedule Ahead for
Global
Determines the number of minutes in advance that schedules are generated.
Missed if Not Run Within
Global
Determines the number of minutes before a cron job that hasn’t yet executed is marked as missed.
History Cleanup Every
Global
Determines the number of minutes that pass before the cron history is cleaned.
Success History Lifetime
Global
Determines the number of minutes that the record of successfully completed cron jobs is kept in the database.
Failure History Lifetime
Global
Determines the number of minutes that the record of failed cron jobs is kept in the database.
Use Separate Process
Global
Determines if cron jobs are executed in parallel as separate processes. Options: Yes / No

default

Cron Group: Default

Field
Scope
Description
Generate Schedules Every
Global
Determines the frequency in minutes, that schedules are generated.
Schedule Ahead for
Global
Determines the number of minutes in advance that schedules are generated.
Missed if Not Run Within
Global
Determines the number of minutes before a cron job that hasn’t yet executed is marked as missed.
History Cleanup Every
Global
Determines the number of minutes that pass before the cron history is cleaned.
Success History Lifetime
Global
Determines the number of minutes that the record of successfully completed cron jobs is kept in the database.
Failure History Lifetime
Global
Determines the number of minutes that the record of failed cron jobs is kept in the database.
Use Separate Process
Global
Determines if cron jobs are executed in parallel as separate processes. Options: Yes / No

MySQL Message Queue Cleanup

Adobe Commerce feature Exclusive feature only in Adobe Commerce (Learn more)

Advanced configuration - MySQL Message Queue Cleanup

Field
Scope
Description
Successful Messages Lifetime
Global
Determines the lifetime of successful messages in minutes. Enter zero to skip the cleanup. Default: 10080 (7 days)
New Messages Lifetime
Global
Determines the lifetime of new messages in minutes. Enter zero to skip the cleanup. Default: 10080 (7 days)
Failed Messages Lifetime
Global
Determines the lifetime of failed messages in minutes. Enter zero to skip the cleanup. Default: 10080 (7 days)
Retry Messages in Progress After
Global
Determines how long the system waits for a message in progress before retrying. Default: 1440 (24 hours)

Mail Sending Settings

Advanced configuration - Mail Sending Settings

For more information about changing these settings, see Configure email communications in the Admin Systems Guide.

IMPORTANT
Security Notice We recommend that all merchants immediately set their mail sending configuration to protect against a recently identified potential remote code execution exploit. Until this issue is resolved, it is highly recommended that you avoid using Sendmail for email communications. In the Mail Sending Settings, make sure that Set Return Path is set to No.
Field
Scope
Description
Disable Email Communications
Store View
Determines if email communications are activated for the store. Options: Yes / No
Transport
Store View
Determines the transport type for email communications from the store. Options: Sendmail / SMTP
Host
Store View
(For SMTP and Windows servers only) Determines the name that is used to refer to the host. Default value: localhost
Port (25)
Store View
(For SMTP and Windows servers only) Identifies the port used for email communications. Default value: 25
Set Return-Path
Store View
Determines if a routing address is used for returned emails. Options: No / Yes / Specified

SMTP options

When you select SMTP at the transport type, additional options are available to configure the SMTP server connection.

Advanced configuration - Mail Sending Settings with SMTP

Field
Scope
Description
Username
Store View
Login user name for the SMTP server.
Password
Store View
Password for the SMTP server login.
Auth
Store View
Determines th authentication type for the SMTP server connection. Options: NONE / PLAIN / LOGIN
SSL
Store View
Determines verification type for the host security certificate. Options: SSL / TLS

Currency

Advanced configuration - Currency

For more information about changing this setting, see Currency configuration in the Stores and Purchase Experience Guide.

Field
Scope
Description
Installed Currencies
Global
Indicates the currencies that are currently available to the Commerce installation. Options include all available currencies, with installed currencies selected.

Security

Advanced configuration - Security

For more information about changing these settings, see Session management in the Admin Systems Guide.

Field
Scope
Description
Max Session Size in Admin
Global
Limit the maximum session size in bytes. Use 0 to disable.
Max Session Size in Storefront
Global
Limit the maximum session size in bytes. Use 0 to disable.

Notifications

Advanced configuration - Notifications

For more information about changing these settings, see System notifications in the Admin Systems Guide.

Field
Scope
Description
Use HTTPS to Get Feed
Global
Determines if Admin notifications are delivered over a secure channel. Options: Yes / No
Update Frequency
Global
Determines the frequency of Admin message updates. Options: 1 Hour / 2 Hours / 6 Hours / 12 Hours / 24 Hours
Last Update
Global
Indicates the date and time of the last message update.

Backup Settings

Advanced configuration - Backup Settings

IMPORTANT
Disabled feature: Backup is disabled by default. Enabling this function may require developer assistance. See the following Installation Guide topic to enable backups: Back up and roll back the file system, media, and database.
NOTE
Deprecation notice: Backup features are deprecated as of v2.3.0. It is recommended that all merchants investigate additional backup technologies and binary backup tools (such as Percona XtraBackup).

For more information about changing these settings, see System backups in the Admin Systems Guide.

Field
Scope
Description
Enable Backup
Global
Determines if the Commerce instance allows backups. Options: Yes / No
Enable Scheduled Backup
Global
(Displayed when Enable Backup is set to Yes.) Determines if the Commerce instance is automatically backed up on a regular schedule. Options: Yes / No
Scheduled Backup Type
Global
(Displayed when Enable Scheduled Backup is set to Yes.) Determines the elements of the Commerce instance that are included in the backup. Options: Database / Database and Media / System / System (excluding Media)
Start Time
Global
(Displayed when Enable Scheduled Backup is set to Yes.) Specifies the hour, minute, and second that the scheduled backup begins.
Frequency
Global
(Displayed when Enable Scheduled Backup is set to Yes.) Determines how often the scheduled backup takes place. Options: Daily / Weekly / Monthly
Maintenance Mode
Global
(Displayed when Enable Scheduled Backup is set to Yes.) Determines if the store is put in maintenance mode during the scheduled backup. Options: Yes / No

Admin Actions Log Archiving

Adobe Commerce feature Exclusive feature only in Adobe Commerce (Learn more)

Advanced configuration - Admin Actions Log Archiving

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

Field
Scope
Description
Log Entry Lifetime, Days
Store View
Determines the number of days that admin actions are kept in the Admin Actions archive. Default: 60
Log Archiving Frequency
Store View
Determines how often the Admin Actions logs are archived. Options: Daily / Weekly / Monthly

Full Page Cache

Advanced configuration - Full Page Cache

For more information about changing these settings, see Full-page caching in the Admin Systems Guide.

Advanced configuration - Varnish Configuration

Field
Scope
Description
Caching Application
Global
Determines the application that is used to manage the full-page cache. Options:
Built-in Application - Not recommended for the production environment.
Varnish Caching - Recommended for the production environment.
TTL for public content
Global
Determines the lifetime of the public content cache in seconds. Default value: 120
Handles param size
global
Specifies the maximum number of layout handles to process on the {BASE-URL}/page_cache/block/esi HTTP endpoint. Restricting the size can improve security and performance. Default value: 100
Varnish Configuration
Access list
Global
Specifies the IP addresses that can purge the Varnish configuration to generate a config file. Separate multiple entries with a comma. Default value: localhost
Backend host
Global
Specifies the backend host that generates config files. Default value: localhost
Backend port
Global
Specifies the backend port that is used to generate config files. Default value: 8080
Grace period
Global
Determines how long Varnish serves stale content if the backend is not responsive. Default value: 300
Export Configuration
Export VCL for Varnish 4
Global
Exports the varnish.vcl file for version 4.
Export VCL for Varnish 5
Global
Exports the varnish.vcl file for version 5.
Export VCL for Varnish 6
Global
Exports the varnish.vcl file for version 6.

Storage Configuration for Media

Advanced configuration - Storage Configuration for Media - File System

For more information about changing these settings, see Use a Media Database in the Content and Design Guide.

Field
Scope
Description
Media Storage
Global
Determines the method used to store media files. Default setting: File System
Environment Update Time
Global
Determines the frequency of the media file environment updates in seconds. Default value: 3600

Advanced configuration - Storage Configuration for Media - Database

IMPORTANT
The database media storage method has been deprecated as of Adobe Commerce and Magento Open Source 2.4.3.
Field
Scope
Description
Media Storage
Global
Specifies database as the method used to store media files.
Select Media Database
Global
Identifies the name of the database used for media storage. Default setting: default_setup
Synchronize
Synchronizes the transfer of all media to the specified database location.
Environment Update Time
Global
Determines the frequency of the media file environment updates in seconds. Default value: 3600

Bulk Actions

Adobe Commerce feature Exclusive feature only in Adobe Commerce (Learn more)

Advanced configuration - Bulk Actions

For more information about changing these settings, see Bulk actions in the Admin Systems Guide.

Field
Scope
Description
Days Saved in Log
Global
Determines the number of days that bulk actions are kept in the Bulk Actions Log archive. Default: 60

Scheduled Import/Export File History Cleaning

Adobe Commerce feature Exclusive feature only in Adobe Commerce (Learn more)

Advanced configuration - Scheduled Import/Export File History Cleaning

For more information about changing these settings, see Scheduled import and export in the Admin Systems Guide.

Field
Scope
Description
Save File, Days
Global
Determines the number of days that import/export history files are saved.
Enable Scheduled File History Cleaning
Global
Enables the scheduled file cleanup of import/export files. Options: Yes / No
Clean Now
Overrides the scheduled cleanup, and immediately cleans the import/export history files.
Start Time
Global
Specifies the hour, minute, and second of the import/export history file cleanup.
Frequency
Global
Determines how often the import/export history files are cleaned. Options: Daily / Weekly / Monthly
Error Email Recipient
Global
The email address of the person who is to receive notification if an error occurs while the import/export file history is cleaned. Separate multiple addresses with a comma.
Error Email Sender
Global
Identifies the store contact that appears as the sender of the notification. Default sender: General Contact
Error Email Template
Global
Identifies the email template that is used for the import/export file cleaning-error notification. Default template: File History Clean Failed

Image Upload Configuration

Advanced configuration - Image Upload Configuration

Field
Scope
Description
Quality
Global
Determines the JPG quality for the resized image. Lower quality reduces the file size. Use 80-90% to help reduce file size with high quality. Default: 80
Enable Frontend Resize
Global
Enable this setting to allow Commerce to resize large, oversized images you may upload for the Product Details page. Commerce resizes the image files using JavaScript before uploading the file. When the image is resized, it keeps the exact proportions to meet and not exceed the largest size for Maximum Width or Maximum Height. Default: Yes
Maximum Width
Global
Determines the maximum pixel width for the image. When the image is resized, it does not exceed this width. Default: 1920
Maximum Height
Global
Determines the maximum pixel height for the image. When the image is resized, it does not exceed this height. Default: 1200

Media Gallery

Advanced configuration - Media Gallery

Field
Scope
Description
Enable Old Media Gallery
Global
Enables or disables the old Media Gallery.

Media Gallery Image Optimization

Advanced configuration - Media Gallery Image Optimization

Field
Scope
Description
Enable Image Optimization
Global
Determines if images are resized to decrease the file size of the images inserted to the content. Original images are preserved in the Media Gallery.
Maximum Width
Global
The maximum width (in pixels) for images inserted from Media Gallery into the content.
Maximum Height
Global
The maximum height (in pixels) for images inserted from Media Gallery into the content.

Adobe Stock Integration

Advanced configuration - Adobe Stock integration

For more information about configuring these settings, see Adobe Stock Integration in the Content and Design Guide.

Field
Scope
Description
Enabled Adobe Stock
Global
Enables or disables the Adobe Stock Integration.
API Key (Client ID)
Global
An API key is required to connect your store to the Adobe Stock service.
Client Secret
Global
The Client Secret for your Adobe Stock integration is required.
Test Connection
Runs a test to verify that the API key is valid for use with the Adobe Stock service.
recommendation-more-help
d39aca6f-58a0-41c6-83eb-39fd0ef30672