> For the complete documentation index, see [llms.txt](https://docs.shopwaive.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shopwaive.com/product-tour/home.md).

# Home

Home in the Shopwaive app: your figures for every program your store uses, with recent activity, At your store and the balance summary

**Home** is the first page of the Shopwaive app. It shows what your customers hold and use, across every Shopwaive program your store uses: balances, the places balances are used, Budgets, company wallets, gift codes and Loyalty. Each figure links to the page where you can see more.

## Who sees it

* **Every staff member who can open the Shopwaive app** sees Home. Open it from your Shopify admin: **Apps** > **Shopwaive** > **Home**.
* **What each store sees depends on its own setup.** A section shows only when your store uses that program. A store with Budgets off sees no Budgets section, and a store with no loyalty program sees no Loyalty section. Nothing is drawn for a program you do not use, not even an empty card.
* **A store whose balance is points** sees Loyalty first, and **Where points are used** in place of **Where balances are used**. The **Balances** section is not drawn there.

## What is on Home, top to bottom

<figure><img src="https://1743155819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6HSAZj4RDucpQwVtzMYt%2Fuploads%2Fgit-blob-defc445facf00f5b85517d706c5e4e47a5bf5e6c%2Fapp-home.jpg?alt=media" alt="Home: four figures in a strip, a greeting, cards with images and a button each, Recent activity, At your store and Balance summary"><figcaption><p>Home in the Shopwaive app</p></figcaption></figure>

1. **The title bar.** **More actions** > **Create report** opens your figures for a period, to read in the app, save to **Files** or download as a PDF.
2. **A banner, only when something needs attention.** For example, a Klaviyo key that stopped working. The banner carries the button that fixes it.
3. **The figures.** Up to four figures in one row, such as **Balance held**, **Balance added**, **Balance used** and **Sales using a balance**, each with a small chart and its change. On a phone, each figure shows its small chart, and its change is in the figure's card: tap the figure to see it. Point at a figure to see more, and click it to open its detail view. See [Metric cards and detail views](https://docs.shopwaive.com/product-tour/home/metric-cards.md). At the top left, the range and the program show in plain words, for example **Last 30 days** · **Balances**. Click them to change the range. At the top right, **Live checkout** with a small blue dot shows the redemptions of the last 30 minutes. Click it to open [Live view](https://docs.shopwaive.com/product-tour/live-view.md).
4. **The greeting**, with your first name and your store.
5. **Tasks**, only when there is real work open.
6. **The setup card, only while your store sets up.** **Show it to your customers** lists the steps that put your Shopwaive balance in front of customers. See [Setup steps](https://docs.shopwaive.com/product-tour/home/setup-and-welcome.md).
7. **Cards.** Each has an image, one line and one button: your open steps, your first balance, Shopify POS tiles, programs your store does not use yet, **What's new** and **Help**. On a computer, point at a card to see a round close button at the top right of its image. Click it to dismiss the card: Home does not show it again.
8. **Recent activity.** What happened lately, by day, with the amount at the right. **View all activity** opens the full list.
9. **At your store.** Each live feature on its own row with its status, such as **Live** or **Ready**, and **Manage** at the top, which opens the exact settings. Click a row to open its place. See [At your store](https://docs.shopwaive.com/shopify/settings/at-your-store.md).
10. **Balance summary.** For the range you chose: the starting balance, what was added, used and adjusted, and the ending balance. **Show daily figures** opens them by day.

<figure><img src="https://1743155819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6HSAZj4RDucpQwVtzMYt%2Fuploads%2Fgit-blob-cb4bd9fe59f63908c161e6b286547b8b8455c727%2Fapp-home-report.jpg?alt=media" alt="The Report page: your figures for a period, with Save, Download PDF and the range"><figcaption><p>The Report page, from More actions, Create report</p></figcaption></figure>

## How the figures are counted

* **Once a day.** Your figures are counted each night, through the end of yesterday in your store's time zone. Opening Home reads the count, so the page opens quickly and nothing on it moves after it appears.
* **Exact to your ledger.** Every figure comes from your Shopwaive ledger entries. **Balance summary** shows that the balance at the start, plus every change, equals the balance at the end.
* **One amount, one place.** A budget's money counts in **Budgets**, and a company wallet's in **Companies**. **Balances** counts everything else.
* **Never mixed.** Points are never added to money, and two currencies are never added together. A store with balances in more than one currency sees its main currency, with "+ n other currencies".
* **Points** show as whole numbers, rounded down, unless **Points decimals** on the **Balance display** page is set to 1 or 2. Exports keep the exact figure.
* **The change** beside a figure is neutral, for example "↑ 7%", with "Up 7% from the 30 days before" when you point at it. "New" means the period before had nothing. Amounts held at a point in time (held, left, outstanding, owed) show no change.

## Set it up step by step

Home needs no setup. It fills in by itself once your store uses Shopwaive:

1. **Install Shopwaive.** Home opens with the setup card. See [Setup steps](https://docs.shopwaive.com/product-tour/home/setup-and-welcome.md).
2. **Give your first balance.** On **Customers**, open a customer and add an amount. For many customers at once, use **Import** on the **Customers** page, the Shopwaive API or Shopify Flow.
3. **Wait for the first count.** Until then Home says "Your figures are being prepared. They are counted once a day. The first count is ready within a day."
4. **Turn on the programs you want.** Each program's section joins Home once your store uses it: **Budgets** (Settings > Checkout), **Loyalty** (the Loyalty page), company wallets, gift codes.

## Tutorial: read last month's balances in 2 minutes

1. Open **Home** and click the range at the top left of Home, for example **Last 30 days**.
2. In **Balances**, read **Balance used**. Point at its spark chart to see each day's figure. The headline and its date follow your pointer, and return to the latest day when you move away.
3. Click the **Balance used** card. Its detail view opens with a full-size chart and a table of each day. Choose **Compare to** > **Previous period** to see the 30 days before beside it. See [Metric cards and detail views](https://docs.shopwaive.com/product-tour/home/metric-cards.md).
4. Click **Export data** to save the figures as a CSV file, or **Create report** for a PDF. **Create report** is also the small report button to the right of **Compare to**. Both are saved to **Files**.
5. Close the detail view. Under **Balance summary**, click **Show daily figures** to see each day's added and used amounts.

## Limits

* **Figures run through yesterday.** Today's activity shows after tonight's count.
* **Share of all your store's sales** is not shown. **Sales using a balance** counts the orders that used a balance, at their full totals with shipping and tax.
* **Used on orders** for gift codes is the codes' starting amounts less Shopify's gift card balances today, read once a night, and is filed by the day each code was made.
* **Budget left** has no spark chart. It is an amount now.
* **Companies** links to the full customer list.
* **Last 12 months** shows the days your store's count holds. A store installed recently sees the days since it installed.
