This article details the maximum product limits in Guide.
Knowledge base limits
The following table shows the maximum limits related to knowledge base functionality in Guide.
| Item | Maximum |
|---|---|
| Article size | 1MB
This translates to approximately 1000000 characters, (excluding āăą or hidden html tags). |
| Total number of articles, excluding archived and translations | 40,000 |
| Total number of articles in a single section | 5,000 |
| Total number of comments per article | 1,000 |
| Total number of labels per article
(not available on Suite Team) |
50 |
| Total number of @mentions in an article | 15 |
| Total number of @mentions in a comment | 15 |
| Total number of content tags per article | 25 |
| Total number of content tags per account | 200 |
| Total number of article verification rules | 20 |
| Total number of items within each filter type in an article verification rule | Filter types and item limits:
|
| Total number of attachments per article | 500 |
| Article attachment size | 20 MB |
| Total number of media per account (images and attachments) | Plan limits:
|
| Total number of categories | 100 |
| Total number of sections in a single category | 100 |
| Total number of section levels
(Enterprise plans only) |
5 |
| Total number of sections in a single section
(Enterprise plans only) |
200 |
| Maximum length of an article content | 65,000 characters |
Content blocks limits
The following table shows the maximum limits for content blocks in the help center.
| Item | Limit |
|---|---|
| Total number of articles that a content block can be used in | 500 |
| Article size | 1MB
This translates to approximately 1000000 characters, (excluding āăą or hidden html tags). |
| Total number of content blocks in one article | 25 |
| Total number of content blocks in one account | 5000 |
| Total number of images per content block | 50 |
| Content block size | 500KB |
| Plan type | Zendesk Suite Enterprise and above or Guide Enterprise and above. |
Search limits
General search limits
The following table shows the maximum limits related to help center search.
| Item | Maximum |
|---|---|
| Native search queries | 300 characters or 50 terms |
| Instant search queries | 300 characters or 100 terms |
| Default snippet size for a search result | 120 characters |
| Content searched within an article | First 100,000 bytes
This translates to approximately 25,000–100,000 characters. |
Federated Search limits
General Federated Search limits
The following table shows the maximum limits related to Federated Search.
| Item | Maximum |
|---|---|
| External records | 50,000 external records |
| External record size | 10,000 bytes/record |
| External sources | 20 |
| External types | 20 |
| Record maximum title length | 255 characters |
| Record maximum body length | 10,000 characters |
Search crawler limits
The following table shows the maximum limits related to the search crawler.
| Item | Maximum |
|---|---|
| Crawlers | 20 |
| Pages in a single sitemap | 50,000 |
External content API limits
Normal Zendesk API rate limits apply to the External content API if no lower rate limit is documented in the following table. For links to external content API documentation, see Federated Search API Introduction.
| Item | Maximum |
|---|---|
| External record creation | 770/min |
Management permissions and user segment limits
The following table shows the maximum limits related to user segment functionality in the help center.
| Item | Maximum |
|---|---|
| Total number of management permissions groups | 200 |
| Total number of user segments | 200 |
| Total number of ALL tags referenced in a user segment | 50 |
| Total number of ANY tags referenced in a user segment | 50 |
| Total number of groups referenced in a user segment | 50 |
| Total number of organizations referenced in a user segment | 50 |
| Total number of individual users (outside of tags, groups, and organizations) in a user segment | 50 |
See Creating user segments for more information about user segments and tags.
Theme limits
| Item | Maximum |
|---|---|
| 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 page templates per article, section, or category | Up to 100 each |
| Individual theme style.css size | 300KB |
| Total number of elements per page (for example, articles, posts, sections, categories, and so on) | 30
For more than 30 elements, you can add the pagination helper {{pagination}} to your Guide theme so users can paginate to view all the elements. |
| Individual theme script.js size | 300KB |
| Total number of settings in manifest.json | 200 |
| Total number of characters in a variable object identifier | 30
Only alphanumeric characters and underscores (_) are allowed. |
| Total number of options in a list type setting | 20 |
| Total number of custom pages | 100 |
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.
Why are there limits?
- 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.
11 Comments
Ouch! These article attachment limits are making it so images do not appear in many of our pages.
The custom page limit of 10 is ridiculous.
Is there any plan to up the maximum amount of articles a content block can be used in? It's currently 200. We'd like to use content blocks as variables for product names, specific UI references, and more that will likely be used well over 200 times. Thanks in advance.
It would be great if the maximum number of user segments could increase from 200. We heavily use this feature to manage our customers' permissions.
David Bjorgen I'm happy to tell your that we have increased the custom pages limit to 100.
Gorka Cardona-Lauridsen this is great news! Thanks for the update.
are these limitations per brand or for the entire subscription? e.g can I have 40,000 articles in each brand?
This is a limit for the entire account.
Is there a way to query or run a report on some of these limits to see how close we are to them? For example, images, is there a way for us to see how many images are currently in our library so we know where we are in relation to the limit?
Thanks for writing in! It looks like there is no reporting tool yet for us to track but we raised this to our guide product team for another look and see their response. Appreciate your feedback here!
Hi Ryan, we got an update from the Guide product team that there is no native way yet for users to have easily accessible reporting on the limits in the UI. Though they usually check it directly in the database… But this is a very good question and they usually see that the worry is mostly around images in the account. At the moment, we recommend submitting this as product feedback here and stay tuned for any announcement since our product team will check if they can surface this information somewhere directly in the product. We hope this information helps!
Please sign in to leave a comment.