Zendesk User Segments
Zendesk user segments are a rule describing a group of people. In Guide, they're the only thing standing between an internal article and the public internet.
What Zendesk user segments are
A user segment is a saved definition of who someone has to be. Not a list of people, a rule. Membership is evaluated when someone visits, so a customer who gains a tag today gains the content today.
Segments can be built from a handful of attributes.
Most accounts ship with two built-in segments: signed-in users, and agents and admins. Those two cover a surprising amount of real need, and plenty of help centres never define a third.
How they gate content
In Guide, visibility is set on sections and inherited by the articles inside them, though an individual article can carry its own segment.
The behaviour when someone is excluded is important and under-explained. The article doesn't appear greyed out or behind a prompt. It does not exist. It is absent from browsing, absent from search, and a direct link produces a not-found or a sign-in page rather than an explanation.
That is the right default for security and a common source of confusion for admins, who see an article perfectly well from their own account and cannot understand why the customer says it is missing. Test signed out and test as a real customer account. Every time.
Segments also pair with a separate management permission that controls who can create and edit articles, which is a different axis entirely. Viewing and editing are configured separately, so check both when something looks wrong.
Recipes worth stealing
Most useful segments follow a small number of patterns.
Keeping the tags honest
Segments built on tags are only as reliable as whatever writes the tags, and that's where these break in practice.
If a tag is applied manually, it will be applied inconsistently. Within a year you have vip, VIP and vip_customer, and your segment catches one of the three. Write tags from an integration or an automation, name them with a convention, and document what each one means somewhere an admin will find.
Audit annually. Users keep tags after they downgrade unless something removes them, so a churned enterprise customer can still be reading your enterprise-only documentation two years later. Nobody notices, because nothing errors.
Keep the total number small, too. Every segment is a rule someone has to understand later, and a help centre with fifteen of them has a permissions model nobody can hold in their head. Three or four well-chosen segments cover most businesses, and the temptation to add a fifth is usually a request that a single article should have handled differently.
Where segments are the wrong tool
Two cases worth naming.
Segments are access control for content, not real security. Article restrictions keep the wrong people from finding an article. Do not put credentials, unreleased financials or anything genuinely sensitive behind one and consider the job done.
And a segment cannot personalise a page. It shows or hides content, wholesale. If you want one article whose middle paragraph differs by customer tier, you want two articles and two segments, or you want the difference to live in your product rather than your documentation.
For the most common application of all of this, see internal knowledge bases.
Frequently asked questions
How do segments control article permissions?
Zendesk Guide permissions attach a user segment to a section or article. Zendesk article permissions are therefore only as good as your segment rules, and Zendesk restricted content leaks when a segment is broader than somebody assumed.
What is a Zendesk user segment?
A saved rule defining a group of users by type, tags, organizations or groups. Guide uses it to decide who can see a section or article.
What do users see if they are excluded?
Nothing. The article is absent from browsing and search, and a direct link gives a not-found or a sign-in prompt rather than an explanation.
How many user segments can I create?
It depends on your plan, and the limits change. Check the current Zendesk docs, and keep the number low anyway, because segments are easier to create than to audit.
Can segments be based on custom user fields?
Tags, organizations, groups and user type are the standard building blocks. If you need something else, write a tag from an automation or an integration and segment on that.
Are user segments secure enough for confidential content?
They are access control for help centre content, not a security boundary. Anything genuinely sensitive belongs somewhere built for it.
Right people, right article
Segments decide who reads what. Ticket Merger decides which of those tickets are the same one.
Start free trial14-day free trial. No credit card required.