Guide knowledge base and theme limits

This article details the maximum limits for articles, user segments, themes, associated files, and assets in Guide.

The limits in this article apply to functionality in Guide Professional and Enterprise, with the exception of number of articles and the number of themes, which applies to all plans.

This article contains the following sections:

• Limits
• Allowable file types for theme assets
• Why are there limits
• About migrated themes and limits
• About article attachment limits

Limits

The following table shows the maximum limits for articles, themes, associated files, and assets in Guide.

Item	Maximum
Total number of articles, excluding archived	40,000
Total number of user segments	200
Total number of themes	10
Individual theme size	30MB
Total theme assets size	25MB
Individual theme asset size	5MB
Individual theme asset name	50 characters
Individual theme template size	300KB
Total number of settings in manifest.json	100
Total number of options in a list type setting	20

Allowable file types for theme assets

The following table shows the file types that are allowed as theme assets. The allowable files types for assets are limited to the file types used in the theming of a Help Center.

Asset type	File types allowed
Images	jpg, jpeg, png, gif, svg, webp, tiff, tif, bmp, ico, webm
Fonts	woff2, woff, eot, otf, ttf
Text files	js, css, html, json, txt, xml
Other	mp4, swf, wav, ogg, mp3

Rich content files types, such as Microsoft PowerPoint, Microsoft Word and PDFs, can be article attachments but cannot be theme assets.

Why are there limits

Theme limits are enforced for a few different reasons:

• For security purposes it’s important to vet the types of files that customers are allowed to upload so that we don’t receive malicious files.
• To prevent misuse or abuse vectors, it's important to limit the total size of files.
• For performance reasons, it’s important to serve, save, import and export files quickly for customers.

For these reasons, we enforce the theme limitations described in this article in Guide.

About migrated themes and limits

On November 14, 2017 we introduced a new theming experience in Guide. When you migrate from the previous theming experience, some new restrictions will be applied to your themes. During the migration process, we suspend some file type and file size limitations to allow you to move your theme and assets to the new theming experience where they will be easier to work with.

For example, if you have a number of PDFs or other files that are no longer supported in theme assets, you will be able to migrate your theme. From there you can export that theme to retrieve all of these files easily. However, you won’t be able to duplicate or re-import that theme until the unsupported files are removed from the theme.

About article attachment limits

Article attachments are governed by their own restrictions and not theming restrictions.

The article attachment limit is 20 MB. See Creating and editing articles in the knowledge base.