{"Status":true,"Message":"","Response":{"post":{"postuid":"ab01938a-ac3a-44ee-87af-71a5eb25fcd1","tenantuid":"d8b744fc-2e70-4089-bb80-dd1d08f6c7b2","projectuid":"fc6490ac-7527-4f49-b06e-46f701280e85","title":"Organizing Content with Categories","slug":"article/organizing-content-with-categories","html":"\u003Cp\u003ECategories group your articles and control how they\u0027re arranged on your documentation site. You manage both categories and articles from the \u003Cb\u003EContent\u003C/b\u003E page, which shows everything in your project as a tree.\u003C/p\u003E\u003Ch2 id=\u0022the_content_page\u0022\u003EThe Content page\u003C/h2\u003E\u003Cp\u003EClick \u003Cb\u003EContent\u003C/b\u003E in the left navigation. Each category is a box that holds its articles and any subcategories. Articles that aren\u0027t in a category appear under \u003Cb\u003EUncategorized Articles\u003C/b\u003E at the bottom.\u003C/p\u003E\u003Cfigure\u003E\u003Cimg class=\u0022lazy-load\u0022 data-src=\u0022https://graffiti-auf7e6dwhxhcbwek.z03.azurefd.net/d8b744fc-2e70-4089-bb80-dd1d08f6c7b2/fc6490ac-7527-4f49-b06e-46f701280e85/images/d4cad9e3b0344df79f9e4154715acf11.png?v=134823837\u0022 data-width=\u00221150\u0022 data-height=\u0022760\u0022 style=\u0022max-width: 100%;\u0022 alt=\u0022Content page with categories and one category expanded to show its articles\u0022/\u003E\u003Cfigcaption\u003EThe Content page\u003C/figcaption\u003E\u003C/figure\u003E\u003Cp\u003EEach article shows its status as a pill: \u003Cb\u003EPublished\u003C/b\u003E, \u003Cb\u003EDraft\u003C/b\u003E, \u003Cb\u003EUnlisted\u003C/b\u003E, \u003Cb\u003EScheduled\u003C/b\u003E or \u003Cb\u003EDeleted\u003C/b\u003E. A published article with unpublished edits also shows \u003Cb\u003EHas Working Copy\u003C/b\u003E. Hover over an article to see when it was last updated.\u003C/p\u003E\u003Ch3 id=\u0022expand_and_collapse_categories\u0022\u003EExpand and collapse categories\u003C/h3\u003E\u003Cul\u003E\u003Cli\u003EClick a category\u0027s name or its arrow to expand or collapse it.\u003C/li\u003E\u003Cli\u003EUse the \u003Cb\u003EExpand All\u003C/b\u003E and \u003Cb\u003ECollapse All\u003C/b\u003E buttons at the top of the page to open or close every category at once.\u003C/li\u003E\u003Cli\u003EHelpGuides remembers which categories you left open, so the tree looks the same the next time you visit.\u003C/li\u003E\u003C/ul\u003E\u003Ch3 id=\u0022search_and_filter\u0022\u003ESearch and filter\u003C/h3\u003E\u003Cp\u003EType in the \u003Cb\u003ESearch ...\u003C/b\u003E box to show only articles whose titles contain your text. Use the \u003Cb\u003EFilter\u003C/b\u003E menu to show articles with one status:\u003C/p\u003E\u003Ctable border=\u00221\u0022 style=\u0022border-collapse: collapse; width: 100%;\u0022\u003E\u003Cthead\u003E\u003Ctr\u003E\u003Cth\u003EFilter\u003C/th\u003E\u003Cth\u003EShows\u003C/th\u003E\u003C/tr\u003E\u003C/thead\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Cb\u003EAll Posts\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003EEvery article (the default)\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Cb\u003EPublished\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003ELive articles\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Cb\u003EDraft\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003EArticles that haven\u0027t been published\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Cb\u003EUnlisted\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003EArticles that are reachable by URL but hidden from navigation\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Cb\u003EScheduled\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003EArticles set to publish at a future date\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Cb\u003EDeleted\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003EArticles in the deleted state\u003C/td\u003E\u003C/tr\u003E\u003C/table\u003E\u003Cp\u003EWhile a search or filter is active, every category with a matching article is expanded and drag-and-drop is turned off. Your filter choice is remembered for the project.\u003C/p\u003E\u003Ch3 id=\u0022reorder_with_drag_and_drop\u0022\u003EReorder with drag and drop\u003C/h3\u003E\u003Cp\u003EEach category and article has a grip handle next to its \u22EE menu. Drag the handle to change the order of categories, or the order of articles within a category. The new order is saved as soon as you drop the item, and it\u0027s the order readers see on your site.\u003C/p\u003E\u003Ccite class=\u0022recommended\u0022\u003E\u003Cspan class=\u0022title\u0022\u003EMoving to another category\u003C/span\u003E\u003Cp\u003EDragging changes the order only. To put an article or category in a different category, use \u003Cb\u003EMove Article\u003C/b\u003E or \u003Cb\u003EMove Category\u003C/b\u003E from its \u22EE menu.\u003C/p\u003E\u003C/cite\u003E\u003Ch2 id=\u0022item_menus\u0022\u003EItem menus\u003C/h2\u003E\u003Cp\u003EClick the \u22EE icon next to any category or article to open its menu.\u003C/p\u003E\u003Ctable border=\u00221\u0022 style=\u0022border-collapse: collapse; width: 100%;\u0022\u003E\u003Cthead\u003E\u003Ctr\u003E\u003Cth\u003EItem\u003C/th\u003E\u003Cth\u003EMenu option\u003C/th\u003E\u003Cth\u003EWhat it does\u003C/th\u003E\u003C/tr\u003E\u003C/thead\u003E\u003Ctr\u003E\u003Ctd\u003ECategory\u003C/td\u003E\u003Ctd\u003E\u003Cb\u003EAdd Article\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003EOpens \u003Cb\u003EAdd an article\u003C/b\u003E with the new article placed in this category\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003ECategory\u003C/td\u003E\u003Ctd\u003E\u003Cb\u003EDelete Category\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003EDeletes the category. Only shown when the category is empty\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003ECategory\u003C/td\u003E\u003Ctd\u003E\u003Cb\u003EEdit Category\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003EOpens the category\u0027s name, description, image and colors\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003ECategory\u003C/td\u003E\u003Ctd\u003E\u003Cb\u003EMove Category\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003EMoves the category under another category, or to the top level\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003EArticle\u003C/td\u003E\u003Ctd\u003E\u003Cb\u003EEdit Article\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003EOpens the article in the editor\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003EArticle\u003C/td\u003E\u003Ctd\u003E\u003Cb\u003EMove Article\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003EMoves the article to a different category\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003EArticle\u003C/td\u003E\u003Ctd\u003E\u003Cb\u003EView Article\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003EOpens the published article on your site in a new tab\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003EArticle\u003C/td\u003E\u003Ctd\u003E\u003Cb\u003ECopy Article URL\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003ECopies the article\u0027s public URL to your clipboard\u003C/td\u003E\u003C/tr\u003E\u003C/table\u003E\u003Cp\u003EYou can also click an article\u0027s title to open it in the editor. \u003Cb\u003EUncategorized Articles\u003C/b\u003E has no menu.\u003C/p\u003E\u003Ch2 id=\u0022create_a_category\u0022\u003ECreate a category\u003C/h2\u003E\u003Col\u003E\u003Cli\u003EOn the \u003Cb\u003EContent\u003C/b\u003E page, click \u003Cb\u003ECreate Category\u003C/b\u003E.\u003C/li\u003E\u003Cli\u003EOn the \u003Cb\u003EName and Description\u003C/b\u003E tab, enter a name and, optionally, a description (up to 500 characters).\u003C/li\u003E\u003Cli\u003EOptionally, open the \u003Cb\u003EImage and Style\u003C/b\u003E tab to add an image and choose colors.\u003C/li\u003E\u003Cli\u003EClick \u003Cb\u003ECreate\u003C/b\u003E.\u003C/li\u003E\u003C/ol\u003E\u003Cp\u003ENew categories are added at the top level. To edit one later, choose \u003Cb\u003EEdit Category\u003C/b\u003E from its \u22EE menu, make your changes and click \u003Cb\u003EUpdate\u003C/b\u003E.\u003C/p\u003E\u003Cfigure\u003E\u003Cimg class=\u0022lazy-load\u0022 data-src=\u0022https://graffiti-auf7e6dwhxhcbwek.z03.azurefd.net/d8b744fc-2e70-4089-bb80-dd1d08f6c7b2/fc6490ac-7527-4f49-b06e-46f701280e85/images/bf571ce68bd24124862cdd6d20f78d19.png?v=166515428\u0022 data-width=\u0022500\u0022 data-height=\u0022463\u0022 style=\u0022max-width: 100%;\u0022 alt=\u0022Add Category dialog with Name and Description and Image and Style tabs\u0022/\u003E\u003Cfigcaption\u003EThe Add Category dialog\u003C/figcaption\u003E\u003C/figure\u003E\u003Ctable border=\u00221\u0022 style=\u0022border-collapse: collapse; width: 100%;\u0022\u003E\u003Cthead\u003E\u003Ctr\u003E\u003Cth\u003EField\u003C/th\u003E\u003Cth\u003ETab\u003C/th\u003E\u003Cth\u003EUsed for\u003C/th\u003E\u003C/tr\u003E\u003C/thead\u003E\u003Ctr\u003E\u003Ctd\u003EName\u003C/td\u003E\u003Ctd\u003E\u003Cb\u003EName and Description\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003EThe category title in the menu, on category pages and on cards. Required\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Cb\u003EDescription\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003E\u003Cb\u003EName and Description\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003EThe text shown on the category\u0027s card, and the page description for search engines\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Cb\u003ECategory Image\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003E\u003Cb\u003EImage and Style\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003EAn icon or image shown on the category\u0027s card\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Cb\u003EForeground Color\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003E\u003Cb\u003EImage and Style\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003EThe text color of the category\u0027s card\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Cb\u003EBackground Color\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003E\u003Cb\u003EImage and Style\u003C/b\u003E\u003C/td\u003E\u003Ctd\u003EThe background color of the category\u0027s card\u003C/td\u003E\u003C/tr\u003E\u003C/table\u003E\u003Ch3 id=\u0022nest_categories\u0022\u003ENest categories\u003C/h3\u003E\u003Cp\u003ETo make a category a subcategory, choose \u003Cb\u003EMove Category\u003C/b\u003E from its \u22EE menu. In \u003Cb\u003EMove To Category\u003C/b\u003E, search for or pick the parent category and click \u003Cb\u003EMove\u003C/b\u003E. Choose \u003Cb\u003ERoot (no parent)\u003C/b\u003E to move it back to the top level. Categories can be nested more than one level deep.\u003C/p\u003E\u003Ch3 id=\u0022delete_a_category\u0022\u003EDelete a category\u003C/h3\u003E\u003Cp\u003EYou can only delete an empty category. Move or delete its articles and subcategories first, and \u003Cb\u003EDelete Category\u003C/b\u003E appears in its menu. Deleting a category doesn\u0027t delete any articles.\u003C/p\u003E\u003Ch2 id=\u0022add_articles_to_a_category\u0022\u003EAdd articles to a category\u003C/h2\u003E\u003Cul\u003E\u003Cli\u003ETo create an article in a category, choose \u003Cb\u003EAdd Article\u003C/b\u003E from the category\u0027s \u22EE menu, enter a \u003Cb\u003EName\u003C/b\u003E, choose a \u003Cb\u003EPost Type\u003C/b\u003E and click \u003Cb\u003EAdd article\u003C/b\u003E.\u003C/li\u003E\u003Cli\u003ETo move an existing article, choose \u003Cb\u003EMove Article\u003C/b\u003E from the article\u0027s \u22EE menu, pick the category and click \u003Cb\u003EMove\u003C/b\u003E.\u003C/li\u003E\u003Cli\u003E\u003Cb\u003ECreate Article\u003C/b\u003E at the top of the page creates an article that isn\u0027t in any category yet.\u003C/li\u003E\u003C/ul\u003E\u003Ch2 id=\u0022how_categories_appear_on_your_site\u0022\u003EHow categories appear on your site\u003C/h2\u003E\u003Cp\u003EYour category tree becomes the navigation for your documentation site:\u003C/p\u003E\u003Cul\u003E\u003Cli\u003E\u003Cb\u003ESidebar menu.\u003C/b\u003E The left menu on every article shows your categories and articles in the same order as the \u003Cb\u003EContent\u003C/b\u003E page. It includes published articles only, and a category with no published articles is left out.\u003C/li\u003E\u003Cli\u003E\u003Cb\u003EHome page.\u003C/b\u003E Your site\u0027s home page shows your welcome message as its heading, followed by a card for each top-level category. The welcome message is set in \u003Cb\u003ESettings\u003C/b\u003E \u2192 \u003Cb\u003EGeneral\u003C/b\u003E \u2192 \u003Cb\u003EWelcome Message\u003C/b\u003E.\u003C/li\u003E\u003Cli\u003E\u003Cb\u003ECategory pages.\u003C/b\u003E Clicking a category opens its page at \u003Ccode\u003E/category/{id}\u003C/code\u003E. It shows the category name, a card for each subcategory and a card for each article.\u003C/li\u003E\u003C/ul\u003E\u003Cfigure\u003E\u003Cimg class=\u0022lazy-load\u0022 data-src=\u0022https://graffiti-auf7e6dwhxhcbwek.z03.azurefd.net/d8b744fc-2e70-4089-bb80-dd1d08f6c7b2/fc6490ac-7527-4f49-b06e-46f701280e85/images/3cc00b67639f47f0a4bc8a45c934f9da.png?v=825944894\u0022 data-width=\u00221300\u0022 data-height=\u0022900\u0022 style=\u0022max-width: 100%;\u0022 alt=\u0022Public docs home page with the category grid and sidebar menu\u0022/\u003E\u003Cfigcaption\u003ECategories on the docs home page\u003C/figcaption\u003E\u003C/figure\u003E\u003Cp\u003ECategory cards use the category\u0027s image, description and colors, so it\u0027s worth filling these in for your top-level categories. You can also show a category\u0027s subcategories inside an article with the subcategories block.\u003C/p\u003E\u003Ch2 id=\u0022related_articles\u0022\u003ERelated articles\u003C/h2\u003E\u003Cul\u003E\u003Cli\u003E\u003Ca href=\u0022/welcome\u0022\u003EWelcome to HelpGuides.io!\u003C/a\u003E, which covers creating and publishing your first article\u003C/li\u003E\u003Cli\u003E\u003Ca href=\u0022/article/keeping-content-fresh-housekeeping-and-stale-articles\u0022\u003EKeeping Content Fresh: Housekeeping and Stale Articles\u003C/a\u003E\u003C/li\u003E\u003Cli\u003E\u003Ca href=\u0022/article/redirects-and-page-not-found-reports\u0022\u003ERedirects and Page Not Found Reports\u003C/a\u003E\u003C/li\u003E\u003Cli\u003E\u003Ca href=\u0022/article/working-with-links\u0022\u003EWorking with Links\u003C/a\u003E\u003C/li\u003E\u003Cli\u003E\u003Ca href=\u0022/article/site-map\u0022\u003ESite Map\u003C/a\u003E\u003C/li\u003E\u003Cli\u003E\u003Ca href=\u0022/article/dashboard\u0022\u003EDashboard\u003C/a\u003E\u003C/li\u003E\u003C/ul\u003E","publish_status":0,"post_type":"Article","authoruid":"3dde8c16-763a-4a2b-ae0b-1d8c50c62e3d","author":{"authoruid":"3dde8c16-763a-4a2b-ae0b-1d8c50c62e3d"},"featured_image_updating":false,"meta_description":"Manage and organize your documentation site effortlessly with categories, articles, drag-and-drop reordering, filtering, and customization options.","display_toc":true,"has_workingcopy":false,"allow_indexing":true,"total_views":0,"date_published":"2026-10-04T21:46:53.823","date_updated":"2026-10-04T21:46:54.533","date_created":"2026-09-28T16:19:40.703"}}}