---
title: Apps and Storefront API tokens
description: "Install an app from its own site, see what it can reach, uninstall it, and create and revoke Storefront API tokens."
---

In **Settings**, press **Apps**. The page says **Apps installed in your store. Each one reaches only the store data you allowed when installing it.** Under the list is the **Storefront API tokens** card.

![The Apps page with No apps installed and the Storefront API tokens card with 0 tokens](/screenshots/settings/130-apps-empty.jpg)

## Install an app

You don't install apps from this page: **Apps you install from an app's own site appear here.** An app's own site sends you to RetailPrime to install it. The example below is a test app called **Order Sync** by **Example Apps Ltd**.

1. RetailPrime shows **Install Order Sync**, **By Example Apps Ltd**. The **Order Sync will be able to** card lists what it asks for, in words and by name, here **View products, collections and catalogs** (`read_products`) and **View orders** (`read_orders`). **About the developer** gives its support email and privacy policy. At the bottom: **Order Sync is made by Example Apps Ltd, not RetailPrime. You can uninstall it at any time from Settings → Apps.**

   ![The Install Order Sync page: what it will be able to do, About the developer, Cancel and Install app](/screenshots/settings/131-install-app.jpg)

2. Press **Install app** to allow it, or **Cancel** to go back to the app without giving it access. After **Install app**, you are taken back to the app's own site.

:::note[Apps on staging]
Apps are registered with RetailPrime by their developers. If you have no app to install on staging, the Apps list stays empty.
:::

## Installed apps

The app is now listed with its **Developer**, the day it was **Installed**, and **Open app**, which opens the app's site in a new tab.

![The Apps page with Order Sync, Example Apps Ltd, Nov 16, 2026, and Open app](/screenshots/settings/132-apps-installed.jpg)

Press the app's name to see its page: **Access** (what it can reach) and **Details** (**Installed by** who and when, support email and privacy policy), with **Open app** and **Uninstall** at the top.

![The Order Sync page: Access with read_products and read_orders, Details, Open app and Uninstall](/screenshots/settings/133-app-page.jpg)

## Uninstall an app

1. On the app's page, press **Uninstall**.
2. A window asks **Uninstall Order Sync?**: **Order Sync loses access to your store at once: its access token stops working and its webhooks are removed. Installing it again starts a new install.**

   ![The Uninstall Order Sync? window with Keep and Uninstall](/screenshots/settings/134-uninstall-app.jpg)

3. Press **Uninstall**. The Apps page says **Order Sync uninstalled.**

   ![The Apps page with Order Sync uninstalled. and No apps installed](/screenshots/settings/135-app-uninstalled.jpg)

## Storefront API tokens

**Tokens let a headless storefront or a server read your store through the Storefront API.** The card counts your tokens. Press **Manage Storefront API tokens**.

The page says **Every token of your store, whether staff or an app created it.** The **Using a token** card explains: **Public tokens go in code that runs in a buyer's browser or app. Private tokens stay on servers; a server acting for a buyer can send the buyer's address in the X-RetailPrime-Buyer-IP header.** and **Send either kind as Authorization: Bearer followed by the token, in a POST to /api/graphql on your store's address.**

![The Storefront API tokens page: Using a token, and No Storefront API tokens](/screenshots/settings/136-tokens-empty.jpg)

### Create a token

1. Press **Create token**. The window says **A Storefront API token reads everything the Storefront API offers. You can revoke it at any time.**
2. Fill it in:

| Box | What to choose | Example |
| --- | --- | --- |
| **Title** (required) | **What it is for, such as "Mobile app".** Without one: **Enter a title.** | `Mobile app` |
| **Kind** (required) | **Public**: **For code in a buyer's browser or app, such as a headless storefront. It is not secret.** **Private**: **For your own or an app's server only. Keep it secret: never put it in a browser or app.** | **Public** |

   ![The Create token window with Mobile app, Public chosen, and the message Enter a title. from pressing Create token with no title](/screenshots/settings/137-create-token.jpg)

3. Press **Create token**. The **Token created** window shows the token once: **Copy the token now. It won't be shown again.** Press **Copy** (it says **Copied**) and keep the token somewhere safe.

   ![The Token created window with the token, Copy, Copied and I have copied this token](/screenshots/settings/138-token-created.jpg)

4. Press **I have copied this token**. The page says **Token Mobile app created.** The list shows each token's **Title**, **Kind**, only its last characters under **Token**, who created it and when.

   ![The token list with Stock sync server (Private) and Mobile app (Public), each with Revoke](/screenshots/settings/139-tokens-list.jpg)

### Revoke a token

1. Press **Revoke** on its row.
2. A window asks **Revoke Stock sync server?**: **Storefronts and servers using this token stop working at once. This cannot be undone.**

   ![The Revoke Stock sync server? window with Keep and Revoke](/screenshots/settings/140-revoke-token.jpg)

3. Press **Revoke**. The token is gone. Back on **Apps**, the card counts **1 token**.

   ![The Apps page with the Storefront API tokens card showing 1 token](/screenshots/settings/141-apps-token-count.jpg)

## What's next

[Domains](/settings-and-apps/domains): give your store an address of your own.
