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.

User type, meaning signed-in end users, or agents and admins.
Tags on the user, which is the most flexible and most used option.
Organizations, so a segment can mean "customers of this specific company".
Groups, for agent-side segments such as tier two only.

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.

Agents and admins, for internal documentation. The built-in one, and the workhorse.
Signed-in customers, for anything you would rather competitors did not read casually. Note that "not casually" isn't the same as secure.
Enterprise or paid tier, defined by a tag your billing integration writes onto the user. Advanced documentation for people who bought the advanced product.
A single organization, for a customer with bespoke arrangements. One segment per major account gets unmanageable fast, so use it sparingly.
Beta participants, by tag. Genuinely the best fit for segments, because the group changes constantly and the rule handles it without anyone maintaining a list.
Partners or resellers, by tag or organization, for margin, escalation routes and co-selling material.

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.

FAQ

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 trial

14-day free trial. No credit card required.