Sellissimo

Store configuration reference

Look up package defaults, environment variables, site overrides and hosting locks.

Browse guides
On this page

Edit defaults and lock a field#

The installer writes config/sellissimo.php. You can also publish it with php artisan vendor:publish --tag=sellissimo-config. Saved settings in the commerce database override inherited values at their documented scope. Regenerate Laravel’s configuration cache after changing hosting defaults. Review existing overrides in Store settings.

For example, lock a currency across sites, lock the shared catalog selection, and lock the guest policy on one site:

'locked_settings' => [
    'currency',
    '@store' => ['product_collections'],
    'fr' => ['guest_checkout'],
],

Core configuration keys#

Inherited setting or existing data Owner and validation
collection, collections, low_stock_threshold Catalog and inventory. Selection uses existing collection handles. The shared threshold is a non-negative quantity used by the stock queue and alerts.
currencies Store details and currency. One currency per site. Existing product and variant prices retain their currency keys. Staff prepare new prices and review availability before switching.
storefront, checkout_countries, checkout_steps, product_urls, account_urls Catalog or Checkout and customers, per site. Validates countries and defaults, registered steps, permitted URLs and route conflicts. Policy links refer to entries. Checkout uses the effective settings.
shipping, carriers, Flat Rate zones Shipping and pickup. Select installed providers. The Flat Rate extension owns countries, region/postcode rules, pay-on-delivery eligibility and amounts keyed by currency. Carrier bookings keep their provider reference.
payments, Stripe presentation, secret, webhook_secret, publishable_key, Mollie key Payments. Site selection controls new orders. The account editor requires a separate permission and checks provider identity and mode. The extension's lock_credentials option gives hosting control of the connection.
tax_settings, taxes, tax classes/zones, discounts and saved promotions Taxes and pricing. Site address and shipping-class preferences use the tax preferences editor. Global tax classes/zones and site or global promotions retain their existing editors and validation. The sample tax calculation and checkout use the same tax rules.
unit_price_providers, order_charge_providers, discount_rules Taxes and pricing. Installed extensions supply the available handles. Checkout runs price and fee rules in the selected order. Existing campaigns can refer to an installed discount rule.
first_order_number, access_days, return policy, product download limits Orders, returns and downloads. The storewide sequence locks when the first order number is issued. Set access and expiry defaults for new orders, and edit the site's return policy in Returns.
Sender, reply-to, site feature flags, staff alert recipients and recovery Emails and notifications and Checkout and customers. The mail sender, receipt and alert jobs use the site's preferences. Reminders respect customer opt-in. Shared retention and inactivity settings apply to the recovery queue.
prefix, connection, sqlite_path, download_disk, download_upload_kb Deployment configuration. These control application routes, storage location and upload limits. The system page reports the route, database and private-disk checks. Publish the package config for hosting overrides.
activity_widget, order_columns_by_role, locked_settings Installation-level CP preferences. Roles and personal order views control the order queue. Hosting config controls widget registration and deployment locks.
Webhook endpoints, subscribed events and delivery attempts Existing outgoing webhooks editor under Integrations and system status. Endpoints receive events across sites and require storewide authorization.

The bundled storefront enables both image controls by default. To keep the full-screen viewer and disable magnification on hover, set the following in config/sellissimo.php and rebuild any configuration cache.

'product_gallery' => [
    'hover_zoom' => false,
    'lightbox' => true,
],

Set lightbox to false to disable the viewer independently. With the package defaults, you can also set SELLISSIMO_PRODUCT_HOVER_ZOOM and SELLISSIMO_PRODUCT_LIGHTBOX in the environment. Test the gallery on a product

Additional defaults and environment variables#

  • guest_checkout defaults to true. Turn it off in Checkout and customers to require an account. account_urls accepts login and register per site. The terms and privacy page pickers link published entries on that site.
  • access_days defaults to 7 and sets the lifetime of signed receipt links. download_days and download_limit default to zero, meaning unlimited. A product or variant can set stricter or different purchased-line terms. download_disk defaults to sellissimo_private and download_upload_kb defaults to 51200.
  • import_disk selects the private Laravel filesystem used for staged catalog files. Keep it available to every worker applying a batch. recovery accepts automatic, inactive_minutes, retention_days and per-site storefront_urls for custom themes.
  • SELLISSIMO_COLLECTION supplies the default collection when collections is empty. SELLISSIMO_CONNECTION chooses the Laravel commerce connection. SELLISSIMO_SQLITE_PATH sets the SQLite database file. SELLISSIMO_STOREFRONT and SELLISSIMO_PREFIX control the bundled shop defaults and URL mount.
  • sellissimo-flat-rate.zones maps service handles to labels, countries, currency amounts and optional region, postcode and collection-on-delivery rules. See Flat Rate Shipping.
  • SELLISSIMO_STRIPE_SECRET, SELLISSIMO_STRIPE_WEBHOOK_SECRET, SELLISSIMO_STRIPE_PUBLISHABLE_KEY and SELLISSIMO_STRIPE_LOCK_CREDENTIALS configure hosting-managed Stripe connections. sellissimo-stripe.presentation sets the hosted or embedded default by site. See Stripe.
  • SELLISSIMO_MOLLIE_KEY and SELLISSIMO_MOLLIE_LOCK_CREDENTIALS configure hosting-managed Mollie connections. See Mollie.

Configure mail transport, private filesystem credentials, encryption, time zone, persistent database storage and the scheduler through Laravel. The effective locale comes from the originating Statamic site. Prepare a production store · Public Core configuration

All guides in Technical reference