Getting started with Guide for your help center: Setting up

Use the knowledge base for the official content provided by your company or organization. The help center consists of categories, sections, and articles.

On Enterprise plans, you can add subsections to your knowledge base to create more levels, see Adding subsections to create more levels in your help center.

Category

Categories are the top-level organizing containers of the help center. Categories contain sections. The help center must have at least one category. If you have only one category in your help center, then the category itself is hidden to end users, and they see only the sections in your help center.

Section

Sections contain related articles. To add a section, you must have at least one category to act as its parent container, except on Enterprise plans. On Enterprise plans, sections can also contain subsections, so a section can be a child of a category or a section, whereas on other plans, each section must be a child of a category.

Articles

Articles are content items such as tech notes or help topics.

You can quickly change the look and feel of the help center using simple WYSIWYG tools. You can easily change the way your content is organized too. You can also use HTML, CSS, JavaScript (see Customizing your help center theme). Code editing is not available for Suite Team.

You can enable your help center to begin building your knowledge base. While your help center is in setup mode, end users can’t see it. This gives you a chance to make it look just how you want before you activate it.

To enable help center in setup mode

1. Sign in to Zendesk Support as the account owner.
   Note: You must be the account owner to enable the help center.
2. Click the Zendesk Products icon () in the top bar, then select Guide.
3. In the page that appears, click Get started.

   If you don’t see this option, but instead your help center opens, it means your help center has already been enabled.

Your help center is created using the default theme. You can customize the theme and add content while it's in setup mode. For next steps, see Preparing your help center for release.

While your help center is in setup mode, you can prepare it for release. During this time, end users cannot view your help center.

These are some of the steps you can take to prepare your help center.

To prepare your help center for release

1. Do some planning for how you will build and launch your help center. See Lisa Painter's Fine tuning: "Blueprinting" your help center.

   Be sure to check out the Pinterest page of beautiful help centers for inspiration.

2. Adjust the look and feel of the help center in setup mode.

   • Brand your help center by adding your product logo and your brand's colors and web fonts. See Branding your help center.

   • Customize your help center (not available on Suite Team). If you're a web designer or a web-savvy administrator, you can make more extensive customizations by editing the page code (see Customizing your help center theme). Also, check out the Help center tips from our community.

3. Test your help center.

   Only agents and administrators can access the help center while it's in setup mode. To see what your help center looks like to end users, see Previewing your help center.

   Be sure to test in different browsers. See the list of browsers supported by help center.

4. Set the display name for your help center.

   The display name can be the same as your subdomain or different. The name appears in the footer of the standard Copenhagen theme (see Changing the name of your help center).

5. Ensure that your default language is properly set for your help center.

   It is important to set your default language before you add any articles to your help center, as the source locale for your articles defaults to your default help center language. A mismatch between the default language and the language you select for your articles could cause your content to not appear.

   Your help center default language is initially determined by the default language setting for your account in the Support admin (see Configuring the default language for your help center).

6. Add your content to the help center.

   • Migrate content from an existing knowledge base or community, if you want (see Migrating existing content to help center).

   • Create knowledge base categories and sections (see Organizing your help center knowledge base content in categories and sections).

     If you migrated content from another system, you won't need to create categories and sections, unless you want to add any.

   • Add articles (see Working with articles in the knowledge base).

     If you're starting from scratch, check out Best practices: Finding issues to populate your knowledge base. If you need an easy way to back up your knowledge base articles, check out the kBackups app in our community.

   • Create user segments to restrict access to content as you'd like (see Creating user segments to restrict help center access). This feature is not available on Suite Team.

7. Set up your help center to support multiple languages (this requires Suite Growth or above or Support Professional or Enterprise with Guide).

   • Decide what content you want to translate and how (see Creating and managing translated content for your knowledge base).

   • Enable languages for your help center (see Configuring your help center to support multiple languages).

   • Create localized versions of your help center content (see Localizing the help center).

8. Add any Guide Admins (see Understanding Guide roles and setting permissions).

When you are ready to go live, you can activate your help center.