docs
  1. SCAYLE Resource Center
  2. Onboarding Guide
  3. Onboarding: Backend
  4. Understanding Your Shop Structure

Understanding Your Shop Structure

The shop structure of SCAYLE consists of two levels:

  1. Shop
  2. Shop Country

All shop countries exist within a shop (see the example shop setup below). This structure is the foundation of your shop.

What is a shop in SCAYLE?

A shop in SCAYLE is a virtual entity in the SCAYLE universe that translates to an online store in the front end. You can structure different shop countries within a shop. Shops are differentiated by their purpose, for example, a B2B shop, an outlet, or a brand.

All shops within your SCAYLE instance share certain product data, such as master categories and attribute groups. Learn more about product data here.

Shop category tree

Your SCAYLE shop setup includes a shared shop category tree. All shop countries use the same shop category structure, however, it is also possible to customize your shop countries by activating and deactivating specific shop categories.

Limit users' access

You can also limit SCAYLE Panel users’ access to a specific shop. Find more details about SCAYLE Panel user access and roles here.

What is a shop country in SCAYLE?

You must create a new shop country for every country and language combination within a shop. For example, a Swiss shop in French is one shop country, and a Swiss shop in German is another, separate shop country.

It is not possible to define a combination of a country and language several different times within one shop, meaning, for example, your shop can only have one shop country for Germany with the language German.

A shop country has access to all shared information from the shop level. Additionally, each shop country can have a specific assortment and shop categories.

An example shop setup

The diagram below shows a setup consisting of two shops and several subsequent shop countries.

A) Shop 1 has three shop countries:

  1. German: German language
  2. Switzerland: German language
  3. Switzerland: French language

B) Shop 2 has three shop countries:

  1. Germany: German language
  2. Netherlands: Dutch language
  3. Denmark: Danish language

Example shop setup

Which shop structure suits your needs?

Use the following questions to decide which shop structure suits you best:

  • What is the purpose of the shops you want to build?
    • Do you need a separate outlet shop? If yes, you create an additional shop for the outlet in SCAYLE.
    • What about different brands that each need their own shop? If yes, configure a new shop in SCAYLE for each brand.
  • Where do you want to sell and deliver products? Each country and language combination requires a new shop country.
  • Do you want to use the same shop category tree for all shop countries? If yes, use the basic setup “shared shop category” tree.

You can use the SCAYLE Panel to set up shops and shop countries. While you can also configure a shop using the Admin API, we recommend doing this only once during setup, making the SCAYLE Panel a more convenient option. Learn more here.

Putting the principles into action

You’ve learned about configuring your shop, so now let’s look at an example. We’ve named our imaginary shop Fashion Store.

For our example Fashion Store, we need to set up shop countries in Germany and Switzerland. Switzerland serves German and French-speaking customers, so we’ll create two shop countries for Switzerland. We’ll use EUR in the German shop country, and CHF in the Swiss shop countries.

Shop Country#Country CodeLanguage CodeCurrency
1DEde_DEEUR
2CHde_CHCHF
3CHfr_CHCHF

You’ll need to consider currency later when assigning prices to variants. Don’t worry, we’ll go into more detail in the following chapters.

Setup of the shop for Fashion Store

  1. In the SCAYLE Panel go to Shops > + New.

You must create at least one shop country in the shop creation wizard. Please have your shop countries in mind before setting up. In our case, we create the shop Fashion Store, and our first shop country will be Germany (with the language set to German).

Create Shop

If you want to set up additional shop countries you can use the Add Another Country button on the shop creation form.

In our case, we add two Switzerland shop countries, one with the language set to German and one in French, both with the currency CHF.

Want to add shop countries to a pre-existing shop?

You can add shop countries in the SCAYLE Panel with the following steps:

  1. Shops > [Shop Name] > Internationalization > Countries > New Country.

If you don’t know the final shop URL right now, don’t worry. You can update your shop’s URL after you’ve created shop countries in the SCAYLE Panel.

Update your shop's URL

  1. Go to Shops > [Shop Name] > Internationalization > Countries > Click on a country name.

You can also update language, billing, and shipping countries in the SCAYLE Panel. But in the case of our demo shop, we don’t need to make any changes.

For legal reasons, please take careful note of how you configure billing addresses, especially for shops within the EU.

Congratulations! You’ve set up Fashion Store’s shop structure in SCAYLE.

Further education - SCAYLE Academy