# Online Store

> Sell online from the Commerce workspace: build a store, take payments, ship orders, and keep the store healthy with the store doctor.

The Online Store lets you build a website that sells your products, take payments, and ship orders. It runs on the same products, customers, and orders as the rest of Workstation, so nothing is copied: an order placed on your store is a normal [order](https://workstation.repzo.com/docs/commerce/orders), the shopper becomes a [contact](https://workstation.repzo.com/docs/sales/contacts), and stock comes from your existing locations.

Everything lives in the **Commerce** workspace. Open it from **Commerce → Commerce** in the main sidebar, or go to `/commerce`.

## Who can use it

Commerce comes with the **Online Store** add-on ($100 / 375 SAR a month with 1 store included, $25 / 95 SAR for each extra store), next to a Starter or Pro plan. If your workspace doesn't have it, the workspace shows an upgrade panel instead. See [Plans & Add-ons](https://workstation.repzo.com/docs/commerce/plans-and-add-ons#online-store).

Two permissions control it:

| Permission | Allows |
|---|---|
| `commerce.view` | Open the Commerce workspace |
| `commerce.manage` | Create and edit sites, design the store, and change Commerce settings |

Pages inside the workspace still check the record's own permissions. For example, **Orders** needs `orders.view`, **Products** needs `products.view`, and **Customers** needs `contacts.view`. Roles that could already read orders get `commerce.view`, and roles that can manage settings get `commerce.manage`.

## The Commerce workspace

The Commerce workspace has its own sidebar, grouped like this:

| Group | Pages |
|---|---|
| (top) | **Home** |
| **Sell** | **Orders**, **Abandoned checkouts**, **Returns**, **Products**, **Collections**, **Reviews**, **Customers**, **Discounts** |
| **Online** | **Stores**, **Landing pages**, **Content** |
| **Grow** | **Marketing**, **Analytics** |
| **Configuration** | **Settings** |

**Back to Workstation** at the bottom of the sidebar returns you to the CRM.

Orders, Products, and Customers are the same screens you know from the CRM, and records open in the same side panel. Products you add here are shared with the CRM, the [Point of Sale](https://workstation.repzo.com/docs/pos), and invoices.

### The site switcher

You can run several sites in one workspace, such as a main store, a brand store, and a set of campaign landing pages. The **Site** picker in the header narrows the workspace to one site, or shows **All sites**. Home, Orders, Abandoned checkouts, Returns, Marketing, and Analytics follow it. Your choice is remembered in your browser.

## Commerce Home

Home is the first page you see. It shows:

- **Orders today**, **Open orders to fulfil**, **Revenue, last 7 days** (canceled orders excluded), and **Products for sale**.
- A warning when some products **aren't for sale online** because they're priced in a currency your store can't convert. Click **Add exchange rates** to fix it, or change the products' currency. The store never sells a product at a wrong price.
- **Get your store ready**, a setup checklist: **Add products**, **Connect payments**, **Set up shipping**, and **Create your store**. Each step links to the page that finishes it.
- The **Store doctor** card for the site picked in the switcher, or your first site.

## Getting a store live

1. Add or review your products in **Products**. See [Products & Collections](https://workstation.repzo.com/docs/online-store/products-and-collections).
2. Turn on at least one way to pay in **Settings → Payments**: cash on delivery or bank transfer. See [Checkout & Payments](https://workstation.repzo.com/docs/online-store/checkout-and-payments).
3. Add delivery zones and rates, or local pickup, in **Settings → Shipping**. See [Shipping & Delivery](https://workstation.repzo.com/docs/online-store/shipping-and-delivery).
4. Create a site in **Sites → New site**, starting from a template or blank. See [Sites](https://workstation.repzo.com/docs/online-store/sites).
5. Click **Customize** to design it in the [store builder](https://workstation.repzo.com/docs/online-store/store-builder), on your own or with [Fox](https://workstation.repzo.com/docs/online-store/fox-in-the-builder).
6. Click **Publish** in the builder.
7. Open the store to shoppers. A new site starts hidden: right after publishing, click **Open to everyone**, or set **Who can visit** to **Everyone (live)** on the Sites page.

Your store is now live at its free address, such as `lina-boutique.myrepzo.com`. You can [connect your own domain](https://workstation.repzo.com/docs/online-store/sites#connect-your-own-domain) at any time.

## What a store is made of

```text
Site            your store or landing pages, with an address and languages
└─ Themes       designs for the site; one is live, the others are drafts
   └─ Pages     home, product, collection, cart, checkout, your own pages…
      └─ Sections   a hero, a product grid, an FAQ…
         └─ Blocks  a heading, a button, a price inside a section
```

- A **site** is either an online store (cart and checkout on) or landing pages only. See [Sites](https://workstation.repzo.com/docs/online-store/sites).
- A **theme** holds the whole design: pages, colors, fonts, and settings. You edit a draft, and **Publish** makes it live. See [Themes](https://workstation.repzo.com/docs/online-store/themes).
- **Pages**, **sections**, and **blocks** are what you arrange in the builder. See [The Store Builder](https://workstation.repzo.com/docs/online-store/store-builder).

## Store doctor

The store doctor is a daily health check of your store. It reads every page of the live theme, plus your payments, shipping, and catalog, and gives the store a **Health score** out of 100.

Findings are grouped by how urgent they are:

| Group | Examples |
|---|---|
| **Needs fixing** | The store isn't published or is hidden, no payment method is on, physical products have no shipping rates, there are no products for sale, products have no price |
| **Worth fixing** | The store is behind a password, products have no photo, images over 1 MB, products that aren't for sale because of a missing exchange rate |
| **Suggestions** | Products without a description, texts not translated into the store's other language, AI shopping is off, no shopping assistant on the store |

Page problems come from the same rules as the builder's [store check](https://workstation.repzo.com/docs/online-store/store-builder#store-check), rolled up so one problem on many pages shows once with a count. Each finding names its area (Checkout, Catalog, Content, Search, Speed, Accessibility, or AI shopping) and has a **Fix** link that opens the right builder page, settings tab, or product list.

The card also shows the change since the last check and how many pages and products were checked. While the store can't sell at all (for example, it isn't published or has no way to pay), the score stays at 40 or below.

The doctor runs by itself every night. Click **Run again** to check now; it runs at most once every 30 seconds per site.

> **From the CLI**
>
> The store doctor can also be read and re-run from the CLI with `repzo store doctor get|run`. This requires the next CLI release. See [Build a store from the CLI](https://workstation.repzo.com/docs/developers/online-store/cli#store-doctor).

## Related pages

- [Sites](https://workstation.repzo.com/docs/online-store/sites)
- [The Store Builder](https://workstation.repzo.com/docs/online-store/store-builder)
- [Checkout & Payments](https://workstation.repzo.com/docs/online-store/checkout-and-payments)
- [Shipping & Delivery](https://workstation.repzo.com/docs/online-store/shipping-and-delivery)
- [Analytics](https://workstation.repzo.com/docs/online-store/analytics)
- [Orders](https://workstation.repzo.com/docs/commerce/orders)
- [Plans & Add-ons](https://workstation.repzo.com/docs/commerce/plans-and-add-ons)
