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. |
Product gallery#
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_checkoutdefaults to true. Turn it off in Checkout and customers to require an account.account_urlsacceptsloginandregisterper site. The terms and privacy page pickers link published entries on that site.access_daysdefaults to 7 and sets the lifetime of signed receipt links.download_daysanddownload_limitdefault to zero, meaning unlimited. A product or variant can set stricter or different purchased-line terms.download_diskdefaults tosellissimo_privateanddownload_upload_kbdefaults to 51200.import_diskselects the private Laravel filesystem used for staged catalog files. Keep it available to every worker applying a batch.recoveryacceptsautomatic,inactive_minutes,retention_daysand per-sitestorefront_urlsfor custom themes.SELLISSIMO_COLLECTIONsupplies the default collection whencollectionsis empty.SELLISSIMO_CONNECTIONchooses the Laravel commerce connection.SELLISSIMO_SQLITE_PATHsets the SQLite database file.SELLISSIMO_STOREFRONTandSELLISSIMO_PREFIXcontrol the bundled shop defaults and URL mount.sellissimo-flat-rate.zonesmaps 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_KEYandSELLISSIMO_STRIPE_LOCK_CREDENTIALSconfigure hosting-managed Stripe connections.sellissimo-stripe.presentationsets the hosted or embedded default by site. See Stripe.SELLISSIMO_MOLLIE_KEYandSELLISSIMO_MOLLIE_LOCK_CREDENTIALSconfigure 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