Setting view permissions on articles with user segments

<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_gpee">
<table>
<tbody>
<tr>
<td>
<strong>All Suites</strong>
</td>
<td>Growth, Professional, Enterprise, or Enterprise Plus</td>
</tr>
</tbody>
</table>
</div>
<div class="article-banner" id="support_with_guide_all">
<table>
<tbody>
<tr>
<td>
<strong>Support with</strong>
</td>
<td>Knowledge Professional or Enterprise</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="body">
<div class="p">
<div class="note note">
<span class="notetitle">Note:</span> Article view permissions are limited on Suite Team. You can allow all users to
view an article or only signed-in users. You cannot restrict content to
admins and agents or a custom user segment.</div>
You can determine which
content users see by setting view permissions. The following options are
available:</div>
<div class="p">
<ul class="ul" id="topic-1__ul_udf_prx_2fb">
<li class="li">
<strong class="ph b">Visible to everyone</strong> includes anyone who visits your help center
and does not require sign in.</li>
<li class="li">
<strong class="ph b">Only visible to selected user segments</strong> select up to 10 user
segments from any of the following (Enterprise plan required to select
multiple user segments):<ul class="ul" id="topic-1__ul_mcg_hct_pbc">
<li class="li">
<strong class="ph b">Signed-in users</strong> includes internal and external users
who create an account and sign in to your help center. </li>
<li class="li">
<strong class="ph b">Agents and admins</strong> includes team members only, so that
you can create content that is internal-only. <div class="note note" id="topic-1__note_qxb_mnm_qxb">
<span class="notetitle">Note:</span> Light agents are included in
this segment. For a list of light agent permissions,
see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408846501402-Understanding-and-setting-light-agent-permissions-" target="_blank">Understanding and
setting light agent
permissions</a>.</div>
</li>
<li class="li">
<strong class="ph b">Custom user segment</strong> allows you to restrict viewing
access to specific users based on tags, organizations, or
groups by applying user segments. See <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408837707290" target="_blank">Creating user
segments to restrict access</a>.</li>
</ul>
</li>
</ul>
</div>
<p class="p">You set view permissions at the article level, not the section or category level. You
must be a Knowledge admin or an agent with publishing permissions to set view
permissions for articles.</p>
<div class="p">
<div class="note tip">
<span class="tiptitle">Tip:</span> You can update article permissions in bulk (see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408836336154" target="_blank">Updating articles in bulk</a>). To
set permissions for all articles in a section, <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408837776666" target="_blank">create an article list</a> filtered
by section, then bulk update the permissions for those articles.</div>
</div>
<p class="p">If visibility for all the articles in a section is internal, then the section will
not be visible to end-users, but if one article in an internal section is visible
to any end-users, then the section will become visible as well.</p>
<p class="p">View restrictions do not apply to Knowledge admins. Admins can access all knowledge base
content, regardless of the view permissions.</p>
<p class="p"><strong class="ph b">To set view permissions for an existing knowledge base article</strong></p>
<ol class="ol" id="topic-1__ol_zzz_kpm_xw">
<li class="li">In <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/9041943683354#topic_dzz_4wn_s2c" target="_blank">help center</a>, navigate to the
article you want to edit, then click <strong class="ph b">Edit article</strong> in the top menu
bar.<p class="p"><img class="image img-screenshot" id="topic-1__image_h2t_dss_ddb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/hc_top_menu_edit_article.png" width="250"></p>
<p class="p">Alternatively, in <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/9041943683354#topic_b5q_nwn_s2c" target="_blank">Knowledge admin</a>, click the
<strong class="ph b">Manage articles</strong> (<img class="image" id="topic-1__image_apx_g4f_3z" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/guide_icon_manage_articles.png">) icon in the sidebar, then select an
article from an article list to open it in edit mode. </p>
</li>
<li class="li">If the <strong class="ph b">Article settings</strong> panel is not displayed in the sidebar, click
the <strong class="ph b">Article settings</strong> icon (<img class="image" id="topic-1__image_ptq_c4n_xbc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/guide-art-settings-icon.png" width="25">) to expand the panel.<p class="p"><img class="image img-screenshot" id="topic-1__image_gf4_f4n_xbc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/guide-art-settings-panel.png" width="350"></p>
</li>
<li class="li">Click the <strong class="ph b">Placement</strong> card to expand the Placement panel.<p class="p"><img class="image img-screenshot" id="topic-1__image_qjq_kxv_xbc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/guide-viewing-permissions-section.png" width="315"></p>
</li>
<li class="li">Under <strong class="ph b">Viewing permissions</strong>, select one of the following options to
determine which users can view this article:<ul class="ul" id="topic-1__ul_kng_tct_pbc">
<li class="li">
<strong class="ph b">Only visible to selected user segments</strong> select up to 10 user
segments from any of the following (Enterprise plan required to
select multiple user segments):<ul class="ul" id="topic-1__ul_lng_tct_pbc">
<li class="li">
<strong class="ph b">Signed-in users</strong> includes internal and external
users who create an account and sign in to your help
center. </li>
<li class="li">
<strong class="ph b">Agents and admins</strong> includes team members only,
so that you can create content that is
internal-only. <div class="note note" id="topic-1__note_mng_tct_pbc">
<span class="notetitle">Note:</span> Light
agents are included in this segment. For a list of
light agent permissions, see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408846501402-Understanding-and-setting-light-agent-permissions-" target="_blank">Understanding and
setting light agent
permissions</a>.</div>
</li>
<li class="li">
<strong class="ph b">Custom user segment</strong> allows you to restrict
viewing access to specific users based on tags,
organizations, or groups by applying user segments.
See <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408837707290" target="_blank">Creating user
segments to restrict access</a>.</li>
</ul>
</li>
<li class="li">
<strong class="ph b">Visible to everyone</strong> includes anyone who visits your help
center and does not require sign in.</li>
</ul>
</li>
<li class="li">Click <strong class="ph b">Update settings</strong>.</li>
</ol>
<p class="p">To set access restrictions in the community, see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408845814170" target="_blank">Applying user segments to restrict access to community
content</a>. </p>
</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/4408824005914",
"url": "https://support.zendesk.com/hc/en-us/articles/4408824005914-Setting-view-permissions-on-articles-with-user-segments",
"headline": "Setting view permissions on articles with user segments",
"description": "You can control article visibility by setting view permissions for specific user segments or making articles visible to everyone, with settings applied at the article level by authorized users.",
"articleSection": "Setting roles and permissions for help center access",
"datePublished": "2021-10-16T03:45:39+00:00",
"dateModified": "2026-01-21T19:43:27+00:00",
"inLanguage": "en-US",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/4408824005914"
},
"author": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"publisher": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"isPartOf": {
"@type": "WebSite",
"name": "Zendesk Help",
"@id": "https://support.zendesk.com/hc/"
},
"about": {
"@type": "SoftwareApplication",
"name": "Zendesk",
"@id": "https://www.zendesk.com",
"softwareAddOn": {
"@type": "SoftwareApplication",
"name": "Knowledge",
"@id": "https://support.zendesk.com/hc/en-us/sections/4405298860954"
}
}
}</script>