Managing custom roles

<body>
<p id="docs-hc-snippet" style="display: none;">Aftercreating a custom agent role, admins andagents in custom roles with permissioncan view the role's permissions, who is assigned to it, and edit the role as needed.</p>
<div class="article-banners">
<div id="docs-wmp-link">
<a href="https://support.zendesk.com/hc/en-us/articles/5411234991258-plan" rel="noopener" target="_blank">What's my plan?</a>
</div>

<div class="article-banner" id="suite_ee">
<table>
<tbody>
<tr>
<td>
<strong>All Suites</strong>
</td>
<td>Enterprise or Enterprise Plus</td>
</tr>
</tbody>
</table>
</div>

<div class="article-banner" id="support_e">
<table>
<tbody>
<tr>
<td>
<strong>Support</strong>
</td>
<td>Enterprise</td>
</tr>
</tbody>
</table>
</div>

</div>
<div id="docs-ai-summary">
<p id="docs-ai-summary-toggle">Summary: <span id="up-triangle">◀</span><span id="down-triangle">▼</span></p>
<p id="docs-ai-summary-content">You can view, edit, and manage custom roles by adjusting permissions and seeing assigned agents. Comparing roles side by side helps review differences and update settings easily. Roles can only be deleted if no agents are assigned, requiring reassignment before deletion. This lets you control team access and responsibilities effectively through role customization and management.</p>
</div>

<div class="body">

<p class="p">After <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408882153882" target="_blank">creating a custom agent role</a>, admins
and <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408882153882" target="_blank">agents in custom roles with permission</a> can
view the role's permissions, who is assigned to it, and edit the role as needed.</p>
<p class="p" dir="ltr">The following topics are covered in this article:</p>
<ul class="ul" id="topic_jsk_lwy_qpb__ul_h2y_pyy_qpb">
<li class="li"><a class="xref" href="#topic_w4w_wyy_qpb">Viewing and editing a custom
role</a></li>
<li class="li"><a class="xref" href="#topic_ifg_yyp_njc">Comparing custom roles</a></li>
<li class="li"><a class="xref" href="#topic_j2x_bzy_qpb">Deleting a custom role</a></li>
</ul>
</div>
<div aria-labelledby="ariaid-title2" class="topic nested1" id="topic_w4w_wyy_qpb">
<h2 class="title topictitle2" id="ariaid-title2">Viewing and editing a custom role</h2>
<div class="body">
<p class="p">From the detailed view of a role, you can edit the role's permissions and access and
see a list of agents assigned to the role. If you're an agent with permission to
manage roles, you can't modify your own role assignment or permissions.</p>
<div class="p">
<strong class="ph b">To view or edit a custom role</strong>
<ol class="ol" id="topic_w4w_wyy_qpb__ol_ap5_1zy_qpb">
<li class="li"><span class="ph">In <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4581766374554#topic_hfg_dyz_1hb" target="_blank">Admin Center</a>, click <img class="image" id="topic_w4w_wyy_qpb__d8e674" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_people_icon.png">
<strong class="ph b">People</strong> in the sidebar, then select <strong class="ph b">Team &gt; Roles</strong>.</span></li>
<li class="li">Hover over the row of the role you want to view, then click the option menu
icon (<img class="image" id="topic_w4w_wyy_qpb__image_ffh_152_4qb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/uc_options_icon.png">) and select <strong class="ph b">View</strong> or <strong class="ph b">Edit</strong>. <img class="image img-screenshot" id="topic_w4w_wyy_qpb__image_jyg_rkp_wqb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/roles_view_edit3.png" width="600"><p class="p">A detailed
view of the custom role's settings is displayed. A list of users
assigned to the role is also visible in a panel on the right.</p>
</li>
<li class="li">If editing the role, make your modifications. Keep the following in mind:<ul class="ul" id="topic_w4w_wyy_qpb__ul_h2j_msd_dzb">
<li class="li">If you’re editing a custom role’s name, note that the name must be
unique and can’t be too similar to the name of an existing
role.</li>
<li class="li">If you're editing a custom role with a name too similar to a system
role, such as <em class="ph i">Admins</em> or <em class="ph i">Team Leads</em>, the description
can't be changed unless the role's name is also changed.</li>
</ul>
</li>
<li class="li">Click <strong class="ph b">Save</strong>
</li>
</ol>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title3" class="topic nested1" id="topic_ifg_yyp_njc">
<h2 class="title topictitle2" id="ariaid-title3">Comparing custom roles</h2>
<div class="body">
<p class="p">Role comparison lets admins select multiple custom roles and view their permissions
side by side in a comparison matrix. The matrix shows which permissions are enabled
for each role and includes expandable sections for more detail. This makes it easier
to compare access levels, review role differences, and update role settings without
opening each role individually.</p>
<p class="p"><strong class="ph b">To compare custom roles</strong></p>
<ol class="ol" id="topic_ifg_yyp_njc__ol_wnj_dzp_njc">
<li class="li"><span class="ph">In <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4581766374554#topic_hfg_dyz_1hb" target="_blank">Admin Center</a>, click <img class="image" id="topic_ifg_yyp_njc__d8e674" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_people_icon.png">
<strong class="ph b">People</strong> in the sidebar, then select <strong class="ph b">Team &gt; Roles</strong>.</span></li>
<li class="li">Click <strong class="ph b">Compare roles</strong>.</li>
<li class="li">In the drop-down list, select the roles you'd like to compare.<p class="p">The comparison
matrix appears with permissions grouped within expandable sections.</p>
</li>
<li class="li">Expand sections to view and compare permissions between roles.<p class="p"><img class="image img-screenshot" id="topic_ifg_yyp_njc__image_tp4_dcq_njc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/compare_custom_roles.png" width="850"></p>
</li>
</ol>
</div>
</div>
<div aria-labelledby="ariaid-title4" class="topic nested1" id="topic_j2x_bzy_qpb">
<h2 class="title topictitle2" id="ariaid-title4">Deleting a custom role</h2>
<div class="body">
<p class="p">You can only delete a role if no agents are assigned to it. If agents are assigned to
the role, you must remove them before you can delete it.</p>
<div class="p">
<strong class="ph b">To delete a custom role</strong>
<ol class="ol">
<li class="li"><span class="ph">In <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4581766374554#topic_hfg_dyz_1hb" target="_blank">Admin Center</a>, click <img class="image" id="topic_j2x_bzy_qpb__d8e674" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_people_icon.png">
<strong class="ph b">People</strong> in the sidebar, then select <strong class="ph b">Team &gt; Roles</strong>.</span></li>
<li class="li">Locate the role you want to delete, click the option menu icon (<img class="image" id="topic_j2x_bzy_qpb__image_igx_f52_4qb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/uc_options_icon.png">), and select <strong class="ph b">Delete</strong>.</li>
<li class="li">Click <strong class="ph b">Delete role</strong> to confirm deletion.</li>
</ol>
</div>
</div>
</div>
<script id="docs-schema-markup" type="application/ld+json">{
"@context": "https://schema.org",
"@type": "TechArticle",
"@id": "https://support.zendesk.com/hc/en-us/articles/4408832292506-Managing-custom-roles",
"url": "https://support.zendesk.com/hc/en-us/articles/4408832292506-Managing-custom-roles",
"headline": "Managing custom roles",
"description": "You can manage custom roles by viewing, editing permissions, comparing roles side by side, and deleting roles when no agents are assigned to them.",
"articleSection": "Team members and groups",
"datePublished": "2021-10-16T03:46:43+00:00",
"dateModified": "2026-06-11T16:56:56.139640+00:00",
"inLanguage": "en-US",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/4408832292506-Managing-custom-roles"
},
"author": {
"@type": "Organization",
"name": "Zendesk",
"url": "https://www.zendesk.com"
},
"publisher": {
"@type": "Organization",
"name": "Zendesk"
},
"isPartOf": {
"@type": "WebSite",
"name": "Zendesk Help",
"url": "https://support.zendesk.com/hc/en-us"
},
"about": {
"@type": "SoftwareApplication",
"name": "Zendesk"
}
}</script><script id="ai-summary-script">
//<![CDATA[
const ai_summary_style = document.createElement('style');
ai_summary_style.innerHTML = `#styled-article-body{padding:0 0 0}#article-body #docs-ai-summary{background-color:#f3f3f3;border:1px solid #d3d3d3;padding:10px 10px 6px;margin-bottom:16px}#article-body #docs-ai-summary #docs-ai-summary-toggle{font-size:.9em;font-weight:700;margin-bottom:4px;cursor:pointer;display:flex;justify-content:space-between;align-items:center}#article-body #docs-ai-summary #docs-ai-summary-toggle #up-triangle{margin-left:auto;padding-right:10px;display:none}#article-body #docs-ai-summary #docs-ai-summary-toggle #down-triangle{margin-left:auto;padding-right:10px}#article-body #docs-ai-summary #docs-ai-summary-content{font-size:.9em;padding-left:25px;padding-right:25px;margin-bottom:12px}`;
document.head.appendChild(ai_summary_style);

const toggleAISummary = () => {
const summary = document.getElementById("docs-ai-summary-content");
const upTriangle = document.getElementById("up-triangle");
const downTriangle = document.getElementById("down-triangle");
if (summary.style.display === "none") {
summary.style.display = "block";
upTriangle.style.display = "none";
downTriangle.style.display = "inline";
} else {
summary.style.display = "none";
upTriangle.style.display = "inline";
downTriangle.style.display = "none";
}
};

document.getElementById("docs-ai-summary-toggle").addEventListener("click", toggleAISummary);
//]]>
</script>
</body>