Preview what a role can access
How to use the role preview to see what a role reaches and compare changes before you save.
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.
Open the preview
Open Settings → Roles & Permissions and click a role.
Change a permission, a profile tab or the dashboard, or leave the role as it is.
Click Preview. A number on the button counts the changes you have not saved yet.
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.
Click Preview. The list Product changes shows every change, marked Added or Removed. The heading Compare role changes introduces the comparison.
Click an entry in the list to jump to the page or tab it affects.
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.
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.
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.
- 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 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
Where Save, Discard and Preview live.
Understand how permissions work
Switches, levels, reach and critical permissions.
Set the profile tabs and dashboard for a role
Tabs and layout the preview shows.
Assign roles and access to users
Give the role to people once it looks right.