Skip to main content

​
Overview

The Store is the central model in Spree. Every resource — products, orders, markets, payment methods, taxonomies — is scoped to a store. Most setups use a single store, but Spree supports multi-store configurations where each store operates independently with its own catalog, branding, and checkout.

​
Store Attributes

AttributeDescription
nameStore name, displayed in the browser title and throughout the site
codeUnique identifier for the store
urlPrimary URL of the store
meta_descriptionSEO description
meta_keywordsSEO keywords
seo_titleCustom SEO title
customer_support_emailEmail for customer support inquiries
mail_from_addressSender address for transactional emails
logo_image_urlURL to the store’s logo
facebook, twitter, instagramSocial media links
payment_methodsPayment methods available in this store

​
Fetching Store Information

Use the store endpoint to get the current store’s configuration — useful for rendering logos, SEO metadata, and footer content: 
const store = await client.store.get()
// {
//   name: "My Store",
//   url: "https://mystore.com",
//   logo_image_url: "https://cdn.mystore.com/logo.png",
//   customer_support_email: "support@mystore.com",
//   payment_methods: [{ id: "pm_xxx", name: "Stripe", kind: "card" }],
//   ...
// }

​
Markets

Markets let you segment your store into geographic regions, each with its own currency, locale, and set of countries. For example, a single store can have:
  • North America — USD, English, ships to US and Canada
  • Europe — EUR, German, ships to DE, FR, AT, NL
  • United Kingdom — GBP, English, ships to GB
See the Markets guide for details.

​
Store Resources

Each store has its own set of resources. This means products, orders, and promotions in one store are completely separate from another.
ResourceRelationship
MarketsA store has many markets, each defining a geographic region with its own currency and locale
OrdersAn order belongs to one store
ProductsA product can be available in multiple stores
Payment MethodsA payment method can be available in multiple stores
Shipping MethodsA shipping method can be available in multiple stores
TaxonomiesA taxonomy belongs to one store
PromotionsA promotion can apply to multiple stores

​
Multi-Store Setup

To run multiple stores from a single Spree installation, see the Multi-Store guide. Each store gets its own domain, branding, catalog, and checkout — while sharing the same admin dashboard and infrastructure.
  • Markets — Multi-region commerce within a store
  • Products — Product catalog
  • Orders — Order management and checkout
  • Multi-Store — Running multiple stores