---
title: Preview what a role can access
description: >-
  How to use the role preview to see what a role reaches and compare changes
  before you save.
icon: eye
sidebar:
  order: 19
  label: Preview role access
  icon: eye
---

**The role preview shows what a role will reach in Fuxam, as a read-only copy of the navigation, before you save anything.** It uses your unsaved edits, so you can see the effect of a change first and keep it or throw it away afterwards.

You open it with the **Preview** button on the page of a role in **Settings → Roles & Permissions**. The button sits in the page header, and again in the **Unsaved changes** bar at the bottom as soon as you edit something. It opens the **Application access preview**.

:::info
You need the **Roles & Permissions** permission. The preview never changes data or assignments. Page contents show clearly labeled preview data, not real records.
:::

## Open the preview

1. Open **Settings → Roles & Permissions** and click a role.

2. Change a permission, a profile tab or the dashboard, or leave the role as it is.

3. Click **Preview**. A number on the button counts the changes you have not saved yet.

4. Read the dialog. At the top you see the role name with its colour, so a renamed unsaved role reads correctly.

The dialog has three tabs, matching the tabs of the role you can preview: **Permissions**, **Profile Information** and **Dashboard**. A badge on a tab counts the unsaved changes in it.

| Tab | What it shows |
|---|---|
| **Permissions** | The **Dashboard pages** the role gets in the navigation. Select a page in the preview sidebar to see whether it is available and whether it is a read-only view. |
| **Profile Information** | The profile tabs of a user, as the role would see them. |
| **Dashboard** | The home dashboard with its tabs. |

If no permission is on yet, the **Permissions** tab says: **Turn on permissions above and this preview will show what they unlock.**

## Compare before you save

As soon as the role has unsaved permission changes, the preview switches to a before and after comparison.

1. Click **Preview**. The list **Product changes** shows every change, marked **Added** or **Removed**. The heading **Compare role changes** introduces the comparison.

2. Click an entry in the list to jump to the page or tab it affects.

3. Look at the page with **Before** and **Now**. On a wide screen both appear side by side and you can drag the divider between them. On a narrow screen, switch with the **Before** and **Now** toggle.

4. Close the dialog. Click **Save** to keep the changes or **Discard** to throw them away.

In the comparison, a page can be marked:

| Message | What it means |
|---|---|
| **New** / **This page was not previously available.** | The change gives the role a page it didn't have. |
| **This page will no longer be available.** | The change takes a page away. |
| **No Changes** | The page is the same before and after. |

If a change doesn't alter what the role reaches, the preview says **These permission changes don't change what this role reaches in the product.** This is common for permissions that only change what someone can do on a page they already see.

:::warning
The preview covers **Permissions**, **Profile Information** and **Dashboard** only. **eID**, **Onboarding** and **Security** are not part of it. They still save and discard with the bar.
:::

## What the preview can't tell you

- It shows pages and tabs, not individual buttons and records. A page can be available while a person still can't edit anything on it. Check the levels in [Understand how permissions work](/docs/fuxam-web/settings/permissions-explained).
- Some controls can only be checked against a real person. If you need certainty, try the role with a test account.
- Access that comes through scopes aimed at individual users or at everyone holding a role can't be simulated in the preview.

## Common pitfalls

| Pitfall | Why it happens | How to avoid it |
|---|---|---|
| A page is missing from the preview | The role lacks a permission the page needs, or its feature is off. | Check the permission in [Understand how permissions work](/docs/fuxam-web/settings/permissions-explained) and the feature in **Features & visibility**. |
| The comparison says nothing changed | The permission you changed only affects actions on pages the role already reaches. | Read the permission's description, or test with a real account. |
| eID or security changes don't show | They are outside the preview. | Check them on their own tabs. |
| The preview is empty | No permission is switched on yet. | Switch on permissions first. |

## FAQ

**Does the preview assign or save anything?**

No. It shows your unsaved edits. Nothing changes for anyone until you click **Save**.

**Why does the preview show sample data?**

So that no real personal data appears. The sample content only shows which pages and tabs are available.

**Do I need unsaved changes to open it?**

No. The **Preview** button in the page header always works. Without changes you see the current state only.

## Related topics

**[Create, edit, copy and delete a role](/docs/fuxam-web/settings/set-up-a-role)**

Where Save, Discard and Preview live.

**[Understand how permissions work](/docs/fuxam-web/settings/permissions-explained)**

Switches, levels, reach and critical permissions.

**[Set the profile tabs and dashboard for a role](/docs/fuxam-web/settings/role-profile-and-dashboard)**

Tabs and layout the preview shows.

**[Assign roles and access to users](/docs/fuxam-web/settings/assign-roles-to-users)**

Give the role to people once it looks right.

