Contents is your content structure
Open Contents in the sidebar to manage the three things that shape how articles are grouped and found: Hubs, Categories, and Tags.
Hubs
- A hub is the column or team pipeline an article belongs to.
- Hubs connect articles to teams, which is what makes the pipeline and team views work.
- Every published article needs a hub. If no hub is assigned, the article cannot be finished.
- Give each hub a clear name. Articles in the same hub appear together in pipeline views and analytics.
Categories
- Categories are the public taxonomy of your site. Each article belongs to exactly one.
- Categories can have subcategories, so Product can contain Announcements and Features.
- Category names and slugs appear in public filters and article URLs, so keep names stable once a category has published content.
- Readers can browse articles by category from the public site.
Tags
- System tags are the shared vocabulary for the workspace. They are grouped by category and can be reused across articles.
- Custom tags are created while writing an article when the tag you need does not exist yet.
- An article can have up to 10 tags in total.
- Authors in the Tags area lists author tags, which identify who wrote or contributed to an article.
- Tags drive public tag pages and tag filters, so use a small, consistent set rather than near-duplicates.
Media
- Media stores images and files used in articles, cover images, logos, favicons, and avatars.
- Upload from the media library, or pick an existing image from the media picker while writing.
- Recommended cover image size is 1200 by 600 pixels. Transparent PNG works best for logos.
- Your plan sets a maximum number of stored files. Removing unused media frees space.
- Deleting a file used by an article or a brand theme removes it from those places.
A structure that stays usable
- Create a small number of hubs that match how your team actually works.
- Build categories from the reader's point of view, not the internal org chart.
- Keep tags to a controlled list and prefer an existing tag over a new near-duplicate.
- Name files clearly before uploading, because media is shared across the workspace.
Note: Renaming a category or tag changes its slug. Do it early, before articles and external links point at the old address.