# Dashboard

URL: https://zerodev.ca/docs/prism/dashboard

> Sign in to /admin, find your way around and give your team access.



The admin dashboard is part of Prism and lives at `/admin` on the same port as your store. There is nothing extra to install or build.

## Signing In

Open `/admin` and sign in with any provider you turned on. Anyone can create an account on your site, but only your team gets into the dashboard:

| Account                                 | What happens                                                                     |
| --------------------------------------- | -------------------------------------------------------------------------------- |
| The license owner                       | Signs in with full access. Matched by the Discord account on your Prism license. |
| A user with a role or extra permissions | Signs in with those permissions.                                                 |
| Anyone else                             | Turned away from `/admin`. They can still use the store and `/account`.          |

People are matched to their user record by Discord ID, or by email once that email is verified. A disabled user cannot sign in to the dashboard and their sessions are ended.

## Pages

| Group  | Page         | What it is for                                                                                          |
| ------ | ------------ | ------------------------------------------------------------------------------------------------------- |
|        | Overview     | Server status, failed modules, update notices and recent audit entries.                                 |
| Store  | Page Builder | Build the landing page and custom pages. See [Storefront](/docs/prism/storefront#page-builder).         |
|        | Theme        | Colours, fonts, store layout and sign-in screen. See [Storefront](/docs/prism/storefront#theme-editor). |
|        | Products     | What you sell, its price, addons and downloads. See [Products](/docs/prism/products).                   |
|        | Licenses     | Every license, its product, owner, addons, status and expiry.                                           |
| Team   | Users        | Everyone with an account, their role, points and status.                                                |
|        | Roles        | Sets of permissions you give to users.                                                                  |
|        | Audit Log    | Every change made in the dashboard, by API tokens and by Prism itself.                                  |
| System | Settings     | Language, branding, server URLs, SMTP, storage, updates, sign-in and checkout.                          |
|        | Modules      | Turn modules on and off.                                                                                |
|        | Configs      | Settings for each module.                                                                               |
|        | Lang         | Edit any text a module shows, per language, with a built-in translator.                                 |
|        | Logs         | The live console.                                                                                       |
|        | API Tokens   | Tokens for the API. See [Storefront API](/docs/prism/api#authentication).                               |

Modules add their own pages. Press `Ctrl K` or `⌘K` to jump to any page or action.

## Roles

Prism creates these roles the first time it starts:

| Role          | Access                                                                              |
| ------------- | ----------------------------------------------------------------------------------- |
| Owner         | Everything. Given to the owner of your Prism license. Cannot be renamed or deleted. |
| Administrator | Everything.                                                                         |
| Viewer        | View users and roles.                                                               |

Edit them or make your own under **Roles**. A role cannot be deleted while users still have it.

### Permissions

| Permission                                     | Allows                             |
| ---------------------------------------------- | ---------------------------------- |
| `products.view`, `.create`, `.edit`, `.delete` | Products, uploads and update logs. |
| `licenses.view`, `.create`, `.edit`, `.delete` | Licenses.                          |
| `team.view`, `.create`, `.edit`, `.delete`     | Users and roles.                   |
| `settings.manage`                              | Settings, Theme and Page Builder.  |
| `modules.manage`                               | Turning modules on and off.        |
| `configs.manage`                               | Module settings.                   |
| `lang.manage`                                  | Module text.                       |
| `logs.view`                                    | The live console.                  |
| `audit.view`                                   | The audit log.                     |
| `tokens.manage`                                | API tokens.                        |
| `*`                                            | Everything.                        |

`products.*` grants every `products.` permission. Modules add their own, such as `kora.view`.

## Adding Your Team

Your team members sign up on the site like anyone else, then you give them access:

1. Go to **Users** and find them, or click **Create** and enter their name, email or Discord ID.
2. Pick a **Role**, or add **Extra Permissions** on top of one.
3. Save. They can sign in to `/admin` straight away.

To find a Discord ID, turn on **Developer Mode** in Discord under **Settings > Advanced**, then right-click the user and click **Copy User ID**.

The owner cannot be disabled or removed. Deleting a user also deletes their sign-in account and ends their sessions.

## Updates

**Settings > Updates** shows your version and the newest one. Click **Check for Updates**, then update to install it. Turn on **Automatic Updates** to install new versions when Prism restarts.