Skip to main content

๐Ÿ›ก๏ธ Role Template Guide

This guide helps you manage Permission Role Templates in the Settings section. Role templates allow you to standardize access across different user roles by assigning them permissions module-wise.


Home > Settings > Role Templates

URL: https://zupians.com/settings/manage-templates


๐Ÿงฑ Overview: Manage Permission Templatesโ€‹

You will see a grid layout displaying all your existing templates.

โœจ Existing Template Cardsโ€‹

Each template is represented as a card with the following elements:

  • Template Name โ€“ e.g., Default, Admin, HR-Recruitment
  • Modules Access Count โ€“ e.g., Modules: 26/26
  • Actions:
    • ๐Ÿ”„ Duplicate โ€“ Clone the existing template.
    • โœ๏ธ Edit โ€“ Modify the template name or description.
    • ๐Ÿ—‘๏ธ Delete โ€“ Permanently remove the template.
      โš ๏ธ Default templates may be restricted from deletion.

Template Card View


โž• Add New Templateโ€‹

Click the + Add Template button in the top-right or Add New Template card at the bottom.

Youโ€™ll see a popup:

  • Template Name: Enter a name (e.g., "Team Lead")
  • Description: Briefly describe the template purpose

๐Ÿ–ฑ๏ธ Click Save to create it.

Add Template Dialog


โœ๏ธ Edit Templateโ€‹

To update a template, click Edit on the desired card. Youโ€™ll get a popup where you can:

  • Modify the template name
  • Update the description

Then click Update.

Edit Template Dialog


๐Ÿ—‘๏ธ Delete Templateโ€‹

Click the Delete button on any card.

A confirmation popup will appear:

  • Action: Click DELETE to confirm or Cancel to abort.

โš ๏ธ Some templates like โ€œDefaultโ€ might be protected.

Delete Confirmation


๐Ÿ“‚ Role Template Detail Viewโ€‹

Clicking on any template card opens a module-wise permission view.
URL format: /settings/manage-templates/{templateId}

Each module listed (e.g., Payroll, Attendance, Recruitment) shows permission checkboxes:

  • โœ… Read
  • โœ… Create
  • โœ… Update
  • โœ… Delete
  • โœ… Reports
  • ๐Ÿ›ก๏ธ Admin Level: read-admin, create-admin, etc.

You can configure permissions per module or use batch actions:

  • Custom Access
  • Assign All Access
  • Revoke All Access

๐Ÿ–ฑ๏ธ Click Save Changes to apply updates.

Role Template Module View


๐Ÿ” Duplicate Templateโ€‹

Use this when you want to reuse permission settings from an existing template.

  • Click Duplicate on a card
  • A new editable copy is created instantly

๐Ÿ“Œ Default Role Templateโ€‹

  • This is automatically assigned to users who donโ€™t belong to any department or are guest profiles.
  • It cannot be modified to be department-specific.
  • Marked with a small โ€œDefaultโ€ badge.

๐Ÿง  Frequently Asked Questions (FAQ)โ€‹

1. Can I assign a role template to multiple users?
Yes. - Use user role mapping to apply a template - One template can be assigned to many users
2. Can I have more than one Default Template?
No. - The system allows only one template to be marked as Default
3. What happens if I remove all permissions in a template?
If all permissions are removed: - The user will have no access to any modules - Youโ€™ll need to reassign access for functionality to resume