{"id":13,"date":"2026-09-09T04:25:19","date_gmt":"2026-09-09T04:25:19","guid":{"rendered":"https:\/\/nirohelp.com\/docs\/13\/settings-reference\/"},"modified":"2026-09-16T14:12:16","modified_gmt":"2026-09-16T08:12:16","slug":"settings-reference","status":"publish","type":"nirohelp_doc","link":"https:\/\/nirohelp.com\/docs\/setup-configuration\/settings-reference\/","title":{"rendered":"Settings reference"},"content":{"rendered":"\n

Every NiroHelp setting lives on one screen: NiroHelp \u2192 Settings<\/strong>. The tabs you see depend on which modules are on – switch the knowledge base off and the
Documentation tab disappears immediately.<\/p>\n\n\n\n

The AI<\/strong> features are not<\/em> a settings tab. They live on their own screen, NiroHelp \u2192 AI<\/strong>, and are covered in AI Assistance<\/a>.<\/p>\n\n\n\n

This page lists every field, its default, and what it does.<\/p>\n\n\n\n

General<\/h2>\n\n\n\n

Modules<\/h3>\n\n\n\n

Turn NiroHelp features on or off. See Turning modules on and off<\/a>.<\/p>\n\n\n\n

Setting<\/th>Default<\/th>What it does<\/th><\/tr><\/thead>
Knowledge base<\/td>on<\/td>Docs, Topics and the docs settings.<\/td><\/tr>
Support tickets<\/td>on<\/td>Tickets, Reasons, Agents, Emails.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\"NiroHelp<\/figure>\n\n\n\n

Documentation<\/h2>\n\n\n\n

Permalinks<\/h3>\n\n\n\n
Setting<\/th>Default<\/th>What it does<\/th><\/tr><\/thead>
Docs URL structure<\/td>the docs page slug, e.g. docs<\/code><\/td>How individual doc addresses are built. Nine choices.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\"permalinks\"<\/figure>\n\n\n\n

See Doc URLs<\/a> \u2014 changing this needs a follow-up step, or your doc links stop working.<\/p>\n\n\n\n

Pages<\/h3>\n\n\n\n
Setting<\/th>Default<\/th>What it does<\/th><\/tr><\/thead>
Docs archive page<\/td>\u2014<\/td>The page that lists your docs. Its slug also sets the docs URL base.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\"Pages\"<\/figure>\n\n\n\n

Display<\/h3>\n\n\n\n

Controls what appears on the docs archive and on a single doc.<\/p>\n\n\n\n

Setting<\/th>Default<\/th>What it does<\/th><\/tr><\/thead>
Docs per page (archive)<\/td>10<\/td>How many docs the archive shows at once.<\/td><\/tr>
Docs shown per topic<\/td>8<\/td>How many docs are listed under each topic.<\/td><\/tr>
Show sidebar<\/td>on<\/td>The sidebar on a single doc.<\/td><\/tr>
Show breadcrumbs<\/td>on<\/td>The trail above the doc title.<\/td><\/tr>
Show prev\/next pagination<\/td>on<\/td>Links to the neighbouring docs.<\/td><\/tr>
Show rating buttons<\/td>on<\/td>The helpful \/ not-helpful buttons. See Reader voting<\/a>.<\/td><\/tr>
Enable comments<\/td>on<\/td>Reader comments on docs.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\"Display\"<\/figure>\n\n\n\n

Cache<\/h3>\n\n\n\n

Doc lists are cached to reduce load. The cache clears itself whenever you save or delete a doc, so a published edit shows straight away.<\/p>\n\n\n\n

Setting<\/th>Default<\/th>What it does<\/th><\/tr><\/thead>
Enable doc list caching<\/td>on<\/td>Turns caching on or off.<\/td><\/tr>
Cache lifetime (seconds)<\/td>3600<\/td>One hour by default.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\"Cache\"<\/figure>\n\n\n\n

Tickets<\/h2>\n\n\n\n

Pages<\/h3>\n\n\n\n

The public pages hosting your ticket shortcodes. Notification emails build their links from these, so keep them selected.<\/p>\n\n\n\n

Setting<\/th>Default<\/th>What it does<\/th><\/tr><\/thead>
My Tickets page<\/td>\u2014<\/td>Where a client sees their own tickets.<\/td><\/tr>
New Ticket page<\/td>\u2014<\/td>Where a client files a ticket.<\/td><\/tr>
All Tickets page<\/td>\u2014<\/td>Optional front-end queue for agents.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\"Tickets<\/figure>\n\n\n\n

Form fields<\/h3>\n\n\n\n
Setting<\/th>Default<\/th>What it does<\/th><\/tr><\/thead>
Fields<\/td>the six built-in rows<\/td>Which fields appear on the new-ticket form, their labels, order and required state.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Built-in fields cannot be deleted, only switched off. You can add your own. See Building the ticket form<\/a>.<\/p>\n\n\n\n

\"form<\/figure>\n\n\n\n

Submission<\/h3>\n\n\n\n
Setting<\/th>Default<\/th>What it does<\/th><\/tr><\/thead>
Allow guest submissions<\/td>off<\/td>Whether a visitor can file a ticket without an account.<\/td><\/tr>
Create accounts for new clients<\/td>off<\/td>Whether a first-time client gets an account made for them.<\/td><\/tr>
Login method<\/td>Verification code<\/td>How clients sign in. See Client login<\/a>.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\"submission\"<\/figure>\n\n\n\n

Behaviour<\/h3>\n\n\n\n
Setting<\/th>Default<\/th>What it does<\/th><\/tr><\/thead>
Tickets per page<\/td>20<\/td>Page size on the front-end ticket lists.<\/td><\/tr>
Auto-transition status on reply<\/td>on<\/td>Whether a reply moves the ticket to Waiting or In Progress. See Ticket statuses<\/a>.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\"behaviour\"<\/figure>\n\n\n\n

Agent assignment<\/h3>\n\n\n\n
Setting<\/th>Default<\/th>What it does<\/th><\/tr><\/thead>
Auto-assign tickets<\/td>on<\/td>Whether new tickets are given an agent automatically.<\/td><\/tr>
Assignment strategy<\/td>Random<\/td>Random, round-robin or least-loaded.<\/td><\/tr>
Max open tickets per agent<\/td>empty<\/td>A cap per agent. Empty means no cap \u2014 read the warning in Auto-assigning agents<\/a> before you set one.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\"agent<\/figure>\n\n\n\n

Emails<\/h2>\n\n\n\n

Every ticket notification is edited here. See Notification emails<\/a> for the placeholders you can use in them.<\/p>\n\n\n\n

Branding<\/h3>\n\n\n\n

Applied to every notification email.<\/p>\n\n\n\n

Setting<\/th>Default<\/th>What it does<\/th><\/tr><\/thead>
Email logo<\/td>\u2014<\/td>An image shown at the top.<\/td><\/tr>
Email footer text<\/td>\u00a9 {year} {site name}. All rights reserved.<\/code><\/td>The small line at the bottom.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\"email<\/figure>\n\n\n\n

The seven emails<\/h3>\n\n\n\n

Each has a Header<\/strong>, a Subject<\/strong> and a Body<\/strong>.<\/p>\n\n\n\n

Section<\/th>Sent to<\/th>When<\/th><\/tr><\/thead>
Login verification code<\/td>Visitor<\/td>A login code was generated.<\/td><\/tr>
Magic link login<\/td>Visitor<\/td>A one-click login link was generated.<\/td><\/tr>
New ticket \u2014 to client<\/td>Client<\/td>A ticket is created.<\/td><\/tr>
New ticket \u2014 to agent<\/td>Agent<\/td>A ticket is created and an agent was assigned.<\/td><\/tr>
Agent replied \u2014 to client<\/td>Client<\/td>An agent answers the ticket.<\/td><\/tr>
Client replied \u2014 to agent<\/td>Agent<\/td>A client answers the ticket.<\/td><\/tr>
Ticket resolved \u2014 to client<\/td>Client<\/td>The ticket is marked Resolved<\/strong>.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\"Email\"<\/figure>\n\n\n\n

Each section says “leave any field blank to skip that piece”<\/em>. That is not what happens.<\/strong> Blanking a body sends an email with an empty body rather than sending nothing. To stop an email going out, ask a developer to unhook it – see Notification emails<\/a>.<\/p>\n\n\n\n

Migration<\/h2>\n\n\n\n

No fields of its own – the tab is the migration screen. See Migrating from other plugins<\/a>.<\/p>\n\n\n\n

\"migration\"<\/figure>\n\n\n\n

Settings edited somewhere else<\/h2>\n\n\n\n

Four groups of settings belong to the AI features and are edited on
\nNiroHelp \u2192 AI<\/strong>, not here:<\/p>\n\n\n\n

Setting group<\/th>Edited on<\/th>Documented in<\/th><\/tr><\/thead>
Connection details<\/td>AI \u2192 Connectivity<\/td>Registering for AI<\/a><\/td><\/tr>
Custom instructions<\/td>AI \u2192 Instructions<\/td>Custom AI instructions<\/a><\/td><\/tr>
Chatbot<\/td>AI \u2192 Chatbot<\/td>Customizing the chatbot<\/a><\/td><\/tr>
Auto responder<\/td>AI \u2192 Auto responder<\/td>The AI auto responder<\/a><\/td><\/tr><\/tbody><\/table><\/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":[3],"class_list":["post-13","nirohelp_doc","type-nirohelp_doc","status-publish","hentry","nirohelp_topic-setup-configuration"],"_links":{"self":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_doc\/13","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=13"}],"wp:term":[{"taxonomy":"nirohelp_product","embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_product?post=13"},{"taxonomy":"nirohelp_topic","embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_topic?post=13"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}