Skip to main content
A project is the container for one shopping experience - its data, its API surface, its releases, and its settings. This page covers creating a new project and the general settings that live at the project root.

​
Create a project

From the admin app, open Settings → Projects and click Add Project.
Create Project dialog with name, description, and Active toggleCreate Project dialog with name, description, and Active toggle
Give the project a name and toggle Active on to start using it right away - the admin app switches to the new project automatically. The dialog asks for nothing else: add a description and pick an Experience Integration afterwards, when you edit the project (see General settings). If you have access to more than one project, the active project is shown as the first item in the breadcrumb at the top of every page. Click it to open a dropdown listing your projects and switch with one click - grouped by team when you belong to more than one. This is also where you switch between teams. When to create a new project: pair each project with a codebase. The Client SDK generated for the project type-checks against that repo, Release Control aligns with the repo’s deploy pipeline, and the GitHub integration assumes the same 1:1 pairing. Add a new project when you’re starting a new codebase - not when you need another market, language, or brand inside an existing experience. Those compose inside the project via regions, locales, domains, and scopes.

​
General settings

Every project has a small set of root-level settings that don’t belong to a specific subsystem. Change them from Settings → Projects: open the project’s menu and choose Edit Project.
  • Name - the human-readable project name shown in the picker and across the admin app.
  • Description - a short sentence to help teammates recognize the project. Optional, and only set here: the Create Project dialog doesn’t ask for it.
  • Active - whether the project is active. Inactive projects are hidden from the picker by default and stop serving public traffic.
  • Avatar - a round image for the project, shown in the project switcher and on the project cards in Settings → Projects. To set it, open Settings → Projects, choose Edit Project from a project card’s menu, and click the avatar at the top of the sheet. Drop or choose an image (PNG, JPEG, or WebP, up to 5 MB), crop it to the circle, and click Save. Without an image, the project shows its initials on a colored circle that stays the same for everyone. Remove brings the initials back.
  • Experience Integration - the integration the Experience Designer builds and publishes against. New experiences inherit it, so with one connected shop you never pick an integration per experience.

​
What to configure next

General settings are intentionally thin - most of a project’s configuration lives in dedicated sections:

Scopes

Segmentation layers for the project - B2B vs B2C, multi-brand, and the default public scope.

Regions

Geographic markets inside a scope, each with its own currency and supported locales.

Locales

The language catalog every region picks from.

Domains

Map incoming URLs to a scope / region / locale triple.

Data Types

Composites and enums you reference when declaring storage fields.

Limits & Quotas

Plan limits that apply to the project.