{"article":{"id":34060994869265,"url":"https://letsdeel.zendesk.com/api/v2/help_center/en-gb/articles/34060994869265.json","html_url":"https://help.letsdeel.com/hc/en-gb/articles/34060994869265-How-to-Create-a-Custom-Admin-Manager-Role","author_id":33852183539473,"comments_disabled":false,"draft":false,"promoted":false,"position":0,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":16926651162129,"created_at":"2025-04-03T14:44:44Z","updated_at":"2026-08-07T11:49:20Z","name":"How to Create a Custom Admin/Manager Role","title":"How to Create a Custom Admin/Manager Role","source_locale":"en-gb","locale":"en-gb","outdated":false,"outdated_locales":[],"edited_at":"2026-08-07T11:49:20Z","user_segment_id":null,"permission_group_id":4402762096145,"content_tag_ids":[],"label_names":[],"body":"<h2 id=\"h_01KM2FT8F5JWHB93J81133FRSH\">Overview</h2><p>This guide provides step-by-step instructions for navigating to the <strong>Create custom role</strong> page in Deel. By following these steps, you will reach the interface where you can create a new custom role from scratch or use an available template to define tailored permission sets and access scopes for your organization.</p><p><strong>Expected Outcome:</strong> You will arrive at the <strong>Create custom role</strong> page, where you can choose to create a new role from scratch or use an available template.</p><h2 id=\"h_01KM2FT8F6M2EFHSSFQHD9GT9E\">Prerequisites</h2><ul><li>You must have permission to view <strong>Organization settings</strong> and manage <strong>Roles and permissions</strong> in Deel.</li></ul><h1 id=\"h_01KM2FT8F6ERBND71PP02795PR\">Step-by-Step Instructions</h1><h2 id=\"h_01KM2NB6NV8YM643T77Z1HPD1D\">Step 1 - Navigate to Organization Settings</h2><p>From the Deel dashboard, locate and click the <strong>Organization settings</strong> icon (gear symbol) in the upper-right corner.</p><p><strong>Navigate to the Security Section. </strong>In the left-hand settings navigation, find and click the <strong>Security</strong> section to expand it.</p><p>Under the expanded Security section, click <strong>Roles and permissions</strong>.</p><p><strong>Expected Outcome:</strong> The Roles and permissions workspace opens.</p><figure class=\"wysiwyg-image\"><img src=\"https://cdn.dev.sammylabs.com/00af2909-a09d-4972-b15f-6d13e7185acc/8cf515b0-48db-46d4-9720-09ea0cd793a1/1/action_ss_9afdd4b3-6ef8-47dc-9732-1ce69a75fd01.png\" alt=\"Organization settings gear icon in Deel\"></figure><figure class=\"wysiwyg-image\"><img src=\"https://cdn.dev.sammylabs.com/00af2909-a09d-4972-b15f-6d13e7185acc/8cf515b0-48db-46d4-9720-09ea0cd793a1/2/action_ss_0b3b8619-737c-4618-948c-2f0106bd6095.png\" alt=\"Security section in the Organization settings navigation\"></figure><figure class=\"wysiwyg-image\"><img src=\"https://cdn.dev.sammylabs.com/00af2909-a09d-4972-b15f-6d13e7185acc/8cf515b0-48db-46d4-9720-09ea0cd793a1/3/action_ss_e5080b79-2d4c-4c03-a4ae-f32d4898a884.png\" alt=\"Roles and permissions option under Security\"></figure><h2 id=\"h_01KM2NFXB51AKYZ6WZ35BNPPM0\">Step 2 - Start Creating a Custom Role</h2><p>At the top of the Roles and permissions page, click the <strong>Roles</strong> tab. Confirm that <strong>Roles</strong> is active and that the page displays a list of roles.</p><p>In the Roles tab, click the <strong>Create role</strong> button located in the upper-right corner.</p><p><strong>Expected Outcome:</strong> You are taken to the custom role creation page, where you can choose to create a role from scratch or use a template.</p><figure class=\"wysiwyg-image\"><img src=\"https://cdn.dev.sammylabs.com/00af2909-a09d-4972-b15f-6d13e7185acc/8cf515b0-48db-46d4-9720-09ea0cd793a1/4/action_ss_2c6d9a77-fcd9-4a62-9c3f-7fbc21bc1e45.png\" alt=\"Roles tab in Roles and permissions\"></figure><figure class=\"wysiwyg-image\"><img src=\"https://cdn.dev.sammylabs.com/00af2909-a09d-4972-b15f-6d13e7185acc/8cf515b0-48db-46d4-9720-09ea0cd793a1/5/action_ss_7eb71a26-ab20-45b5-9361-43bf67375643.png\" alt=\"Create role button in the Roles tab\"></figure><h2 id=\"h_01KM2NKRX91R9DGR1SZFR6CAQF\">Step 3 - Verify the Custom Role Creation Page</h2><p>Confirm that the page title is <strong>Create custom role</strong>. You should see a <strong>Create your own</strong> card and available templates, such as <strong>Head of Department</strong>.</p><p>To build a role from scratch, select <strong>Create custom role</strong> in the <strong>Create your own</strong> card. To use a template, select <strong>Use template</strong> on the template that best matches the role you want to create.</p><p>Define the role name, permissions, and access scope, then save the role.</p><figure class=\"wysiwyg-image\"><img src=\"https://cdn.dev.sammylabs.com/00af2909-a09d-4972-b15f-6d13e7185acc/8cf515b0-48db-46d4-9720-09ea0cd793a1/6/done_ss_534cc94c-e932-4527-bce6-d4f5a62a7f03.png\" alt=\"Custom role creation page with options to create your own or use a template\"></figure><p><strong>Success Criteria:</strong> The custom role creation page is displayed, showing options to create a new role from scratch or use a template. You can now define the details and permissions for your new custom role.</p><h2 id=\"h_01KM2FT8F6J12PZ61HS4YYK83G\">Troubleshooting</h2><ul>\n<li>\n<strong>Missing Access:</strong> If you do not see the Organization settings icon, the Security section, or Roles and permissions, verify that your account has permission to view Organization settings and manage Roles and permissions.</li>\n<li>\n<strong>Roles Tab Not Active:</strong> If you see the People tab instead of the role list, click the <strong>Roles</strong> tab. The People tab is used to manage people and their role assignments, not to create roles.</li>\n<li>\n<strong>Create Role Missing or Unavailable:</strong> Confirm that you are on the <strong>Roles</strong> tab. If the button still does not appear or cannot be selected, ask an organization administrator to grant the required role-management permission.</li>\n<li>\n<strong>Page Not Loading:</strong> If any page fails to load, try refreshing your browser, clearing your cache, or checking your internet connection. You can also try a different browser.</li>\n</ul><p>If you encounter persistent issues, contact your organization's Deel administrator or Deel support for further assistance.</p>","user_segment_ids":[]}}