Sites

For anyone running more than one storefront, and for anyone wondering what the site selector on half the screens is for. A site is one storefront inside your organization.

Most organizations have exactly one, created when they connect a store, and never think about this page again.

What a site holds

PropertyWhat it does
NameWhat you call it in the dashboard.
SlugThe short handle imports and widgets name it by. Unique within the organization.
Base URLYour storefront's address, used to build links back to it from emails and customer pages.
BrandingA logo, a square icon and five colors, used on emails and customer-facing pages.

Manage them under Settings → Sites.

When to add a second

  • A separate brand with its own look and its own reviews.
  • A separate region or domain, where the same products are sold at different prices or in a different language.
  • A second Shopify store connected to the same organization.

Not for a staging copy of your store. Use a separate organization for that, so test data never mixes with real customers.

What is scoped to a site

Reviews belong to the site they were left on, and the ratings a widget shows are the ratings for that site.

Products can appear on several sites. The import takes a list of sites per product, so one catalog can serve two storefronts.

Customers and orders belong to the organization, not to a site, so a shopper who buys from both of your storefronts is one customer with one loyalty balance.

Loyalty programs apply to every site, including sites you add later, so loyalty works before you have thought about any of this. What is per site is the loyalty page URL the member emails link to, set under Settings, Loyalty. An integration that wants a program on only some sites can detach it through the API; the admin never does.

Email branding comes from the site, so a review request about an order on one storefront carries that storefront's logo and colors.

Branding

Upload a logo and a square icon, and set the five colors: primary, page, content, text and muted. They are used on the emails Cascade sends and on the customer-facing pages it hosts (the review form, the shared wishlist page, the unsubscribe page).

Preview a template after changing them, under Settings → Email templates. Colors that look right in the dashboard can be unreadable in an email client's dark mode.

Deleting a site

Deleting a site removes what belongs to it. Reviews left on it, and the link between it and its products, go with it. This is not the way to disconnect a store: disconnect the integration instead and keep the data. See Connecting Shopify.

Sites and the API

Imports name a site by slug rather than by ID, so your integration does not have to look one up:

{ "sites": [{ "site": "my-store" }] }

The widgets resolve the site from the publishable key and the product they are rendering, so there is nothing to configure per site on your storefront beyond pointing each storefront at the right key.