In this Spree user doc, you’ll learn how to configure important store settings.
The Store Details section allows you to configure key settings that determine how your store is presented to customers and how it operates behind the scenes. From your store’s name and logo to currency, locale, time zone, and units of measurement, this section is where you define your store’s identity and core operational preferences.To configure these settings, navigate to the Store Details tab of the Settings menu.
Name: This is the public-facing name of your store. It will appear in headers, footers, and other storefront areas.
Logo: Upload a store logo (recommended size: 240x240 px). This image is used only in the admin dashboard. For the storefront logo see Storefront Themes → Theme Editor.
If you’re running a multi-region store (or operate in a country with multiple languages or currencies) this section lets you configure how prices and languages are displayed to your customers, and allows you to limit the regions you ship to:
Default currency: Choose the primary currency used for your store’s pricing and transactions.
Supported currencies: Select additional currencies, if applicable.
Default country: Set the primary country where your business is based.
Shipping zones: Manage zones to define where products can be shipped.
Default locale: Set the primary language for your storefront.
Default locales: Define additional locales.
Currencies and languages are selected from predefined lists, whereas Shipping Zones can be configured in the Zones tabs of the Settings menu.
If you enable multiple locales or currencies, the storefront will automatically display a language and currency selector to your customers.
JWT (JSON Web Token) authentication allows secure, stateless communication between your store and external services or frontends. It’s commonly used when integrating with custom storefronts, mobile apps, or third-party platforms, ensuring users can be authenticated without relying on server-side sessions.If your store uses JWT for authentication, specify the JWKS endpoint here. Ensure the URL includes a valid protocol (e.g., https://).
Set a default commission percentage that your platform takes from vendor sales. This ensures consistent and automated revenue sharing across your marketplace.Different commission rates can be set per vendor when inviting them to join your marketplace. See the support article on Invite a Vendor for more details.
Here you can configure how and when vendors receive their earnings. Depending on your setup, this may involve automatic payouts via Stripe Connect or manual disbursements. The payout schedule can be: