{"id":14,"date":"2026-09-09T04:25:19","date_gmt":"2026-09-09T04:25:19","guid":{"rendered":"https:\/\/nirohelp.com\/docs\/14\/creating-your-first-doc\/"},"modified":"2026-09-16T14:27:23","modified_gmt":"2026-09-16T08:27:23","slug":"creating-your-first-doc","status":"publish","type":"nirohelp_doc","link":"https:\/\/nirohelp.com\/docs\/knowledge-base\/creating-your-first-doc\/","title":{"rendered":"Creating your first doc"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Writing a doc is exactly like writing a post or a page: the same editor, the same media library, the same revisions.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The Docs screens are available to administrators and editors. If someone with a NiroHelp role cannot see them, read <a href=\"https:\/\/nirohelp.com\/docs\/setup-configuration\/roles-and-permissions\/\" target=\"_blank\" rel=\"noopener\">Roles and permissions<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Add a new doc<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">1. Go to <strong>NiroHelp \u2192 Docs \u2192 Add New<\/strong>.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full has-custom-border\"><img loading=\"lazy\" decoding=\"async\" width=\"999\" height=\"345\" src=\"https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/add-docs.webp\" alt=\"add docs\" class=\"has-border-color has-ast-global-color-0-border-color wp-image-131\" style=\"border-width:2px\" srcset=\"https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/add-docs.webp 999w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/add-docs-300x104.webp 300w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/add-docs-768x265.webp 768w\" sizes=\"auto, (max-width: 999px) 100vw, 999px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">2. Enter a title. The slug comes from it and becomes the last part of the address.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">3. Write the body. The block editor and the classic editor both work &#8211; see <a href=\"https:\/\/nirohelp.com\/docs\/knowledge-base\/code-blocks-and-images\/\" target=\"_blank\" rel=\"noopener\">Code blocks and images<\/a> for the two places they behave differently.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">4. Pick one or more <strong>Topics<\/strong> in the sidebar. Topics are the chapters of your knowledge base.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">5. Optionally pick a <strong>Product<\/strong>, if you cover several product lines.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">6. Set a <strong>Featured Image<\/strong> for the thumbnail in the archive.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">7. <strong>Publish<\/strong>.<\/p>\n\n\n\n<ol class=\"wp-block-list\"><\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">Drafts and revisions<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Docs are ordinary WordPress content, so you get <strong>Save Draft<\/strong>, scheduled publishing, <strong>Preview<\/strong> and the full revision history.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Only published docs are sent to the AI when you sync, and views are not counted on previews or for anyone who can edit the doc &#8211; so drafting never distorts your dashboard figures.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Putting docs in order<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Docs appear in the order you set, not alphabetically, and that order applies everywhere: the archive, the topic listings, and the previous\/next links at the bottom of a doc.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You set it by <strong>dragging rows<\/strong> on <strong>NiroHelp \u2192 Docs<\/strong>. Drop a row in its new place and the order is saved for you. Topics are reordered the same way on <strong>NiroHelp \u2192 Topics<\/strong>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Two things to know:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>There is no numeric <strong>Order<\/strong> column to type into. The two NiroHelp columns on the doc list are <strong>Upvotes<\/strong> and <strong>Downvotes<\/strong>, and neither sorts when you click its heading.<\/li>\n\n\n\n<li><strong>Dragging only reorders what is on screen.<\/strong> Set the per-page count high enough to see the whole topic before you rearrange it.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Where the doc shows up<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>On the docs archive<\/strong> \u2014 the page hosting the docs shortcode, grouped by topic.<\/li>\n\n\n\n<li><strong>At its own address<\/strong>, built from the structure you picked under <strong>Settings \u2192 Documentation \u2192 Permalinks<\/strong>. See <a href=\"https:\/\/nirohelp.com\/docs\/knowledge-base\/doc-urls\/\" target=\"_blank\" rel=\"noopener\">Doc URLs<\/a>.<\/li>\n\n\n\n<li><strong>In the AI knowledge base<\/strong>, but only <strong>after<\/strong> you click <strong>Sync Docs<\/strong> on <strong>NiroHelp \u2192 AI<\/strong>. Until you do, the chatbot and auto responder keep answering from the previous sync. See <a href=\"https:\/\/nirohelp.com\/docs\/ai-assistance\/syncing-docs\/\" target=\"_blank\" rel=\"noopener\">Syncing docs to the AI<\/a>.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>There is no topic archive page.<\/strong> Opening a topic or product address does not list that topic&#8217;s docs &#8211; it sends the visitor to the first doc in the topic instead. If you want a browsable listing, that is what the archive page and its topic grouping are for.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Caching<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Doc lists are cached for an hour by default, controlled under <strong>Settings \u2192 Documentation \u2192 Cache<\/strong>. The cache clears itself whenever a doc is saved or deleted, so a published edit shows straight away. If a listing ever looks stale, saving any doc refreshes it.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large has-custom-border\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"255\" src=\"https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/Cache-1024x255.webp\" alt=\"Cache\" class=\"has-border-color has-ast-global-color-0-border-color wp-image-124\" style=\"border-width:2px\" srcset=\"https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/Cache-1024x255.webp 1024w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/Cache-300x75.webp 300w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/Cache-768x191.webp 768w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/Cache.webp 1036w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n","protected":false},"author":1,"featured_media":0,"template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}}},"nirohelp_product":[],"nirohelp_topic":[4],"class_list":["post-14","nirohelp_doc","type-nirohelp_doc","status-publish","hentry","nirohelp_topic-knowledge-base"],"_links":{"self":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_doc\/14","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_doc"}],"about":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/types\/nirohelp_doc"}],"author":[{"embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/users\/1"}],"wp:attachment":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/media?parent=14"}],"wp:term":[{"taxonomy":"nirohelp_product","embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_product?post=14"},{"taxonomy":"nirohelp_topic","embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_topic?post=14"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}