Admin: Settings

The Settings group in the admin contains eight configuration pages. Changes take effect immediately after saving.

Store Settings #

Core identity and global display options for your store.

• Store name — appears in the browser tab, email headers, and the storefront header.
• Contact email — the address used for outgoing system emails (order confirmations, support replies, etc.).
• Currency — the default currency displayed site-wide.
• Timezone — affects order timestamps, scheduled jobs, and report date groupings.
• Notification bar — enable or disable the thin announcement bar shown above the header. Set the message text when enabled.
• Global banner — a full-width HTML block for site-wide announcements (promotions, shipping notices, etc.). Paste raw HTML to add links, bold text, or custom styling.
• Social links — URLs for your social media profiles. These populate the social icons in the footer.
• Logo and favicon — upload your store logo and favicon.
• Demo mode — when enabled, checkout is blocked and a banner informs visitors that the store is in demo mode. Use this when presenting the store to stakeholders.

Catalog Settings #

Controls product display and stock behaviour.

• Featured products limit — how many products appear in the Featured Products section on the homepage.
• Related products limit — how many related products are shown on each product detail page.
• Low-stock threshold — products at or below this stock level are flagged in the Low Stock Alert dashboard widget and in the Products list. Default is 5.
• Back-in-stock subscriptions — enable or disable the ability for shoppers to subscribe to restock notifications for sold-out products. When disabled, the subscription form is hidden on the storefront.
• Sort products with images first — when enabled, products that have at least one image are listed before products with no images. Useful for stores that are still building out their catalogue.

Checkout Settings #

Controls cart reservation, order lifecycle, and shipping behaviour.

• Inventory reservation TTL — how many minutes stock is held for a cart that has entered checkout but not yet paid. After this window expires, the reservation is released back to available stock. Default is 15 minutes.
• Pending order TTL — how many hours an unpaid order is kept before it is automatically cancelled. Default is 24 hours.
• Free shipping threshold — cart totals at or above this amount qualify for free shipping. Set to 0 to disable free shipping.
• Default country — pre-selected in the country field at checkout. Shoppers can change it.
• Order number prefix — a short string prepended to every order number (e.g. ORD produces ORD-000001). Leave blank for numeric-only order numbers.

Search Settings #

Controls search results display.

• Results per page — the number of products shown on the search results page.
• Autocomplete result count — the number of suggestions shown in the search dropdown as the shopper types.

CMS Settings #

Controls homepage content, social sharing defaults, and analytics integrations.

• Hero slide image URLs — the image URLs used in the rotating homepage hero banner. One URL per slide.
• Homepage marketing copy — headline and subheading text shown in the hero banner or homepage intro section.
• Default Open Graph image — the fallback image used when a page is shared on social media and no product or category image is available.
• Google Analytics 4 measurement ID — your GA4 measurement ID (format: G-XXXXXXXXXX). Leave blank to disable GA4 tracking.
• Google Tag Manager container ID — your GTM container ID (format: GTM-XXXXXXX). Leave blank to disable GTM.
• Twitter/X handle — used in Twitter Card meta tags to attribute shared content to your account.

API Settings #

Controls rate limiting and token expiry for the REST API.

• Rate limiting — master toggle to enable or disable rate limiting for all API requests.
• Authenticated requests per minute — the request limit for clients using a valid API token.
• Public requests per minute — the request limit for unauthenticated (IP-based) requests.
• Admin token TTL — how long admin-issued API tokens remain valid before expiring.
• Customer token TTL — how long customer-issued API tokens remain valid.

See API Adapters for instructions on creating and managing API tokens.

Cache Maintenance #

One-click buttons to clear and rebuild individual application caches. Use these if pages or settings are not reflecting recent changes.

Cache Maintenance is also accessible from Admin → System → Cache Maintenance. See Admin: System for more context.

Homepage Manager #

Curate the product collections shown on the homepage: New Arrivals, Top Rated, and the Hero Pool. See Admin: CMS for full details.