{"id":21,"date":"2026-09-09T04:25:35","date_gmt":"2026-09-09T04:25:35","guid":{"rendered":"https:\/\/nirohelp.com\/docs\/21\/ticket-form-fields\/"},"modified":"2026-09-16T16:29:59","modified_gmt":"2026-09-16T10:29:59","slug":"ticket-form-fields","status":"publish","type":"nirohelp_doc","link":"https:\/\/nirohelp.com\/docs\/ticket-management\/ticket-form-fields\/","title":{"rendered":"Building the ticket form"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">The new-ticket form is not fixed. You can rename, reorder, require, switch off or add fields without touching any code.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Configure it under <strong>NiroHelp \u2192 Settings \u2192 Tickets \u2192 Form fields<\/strong>.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full has-custom-border\"><img loading=\"lazy\" decoding=\"async\" width=\"1313\" height=\"761\" src=\"https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/Tickets-form-field.webp\" alt=\"Tickets form field\" class=\"has-border-color has-ast-global-color-0-border-color wp-image-146\" style=\"border-width:2px\" srcset=\"https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/Tickets-form-field.webp 1313w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/Tickets-form-field-300x174.webp 300w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/Tickets-form-field-1024x593.webp 1024w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/Tickets-form-field-768x445.webp 768w\" sizes=\"auto, (max-width: 1313px) 100vw, 1313px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Each field is one row, and each row has these columns:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Column<\/th><th>What it does<\/th><\/tr><\/thead><tbody><tr><td><strong>Enabled<\/strong><\/td><td>Unticking it removes the field from the form entirely.<\/td><\/tr><tr><td><strong>Required<\/strong><\/td><td>Marks the field required.<\/td><\/tr><tr><td><strong>Label<\/strong><\/td><td>What the client sees. Change it freely.<\/td><\/tr><tr><td><strong>Placeholder<\/strong><\/td><td>Hint text inside the box.<\/td><\/tr><tr><td><strong>Type<\/strong><\/td><td>A badge for built-in fields, because their type is fixed. A dropdown for your own fields.<\/td><\/tr><tr><td><strong>Options<\/strong><\/td><td>For dropdown fields only. One choice per line.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">The six built-in fields<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Field<\/th><th>Default label<\/th><th>Type<\/th><th>Required by default<\/th><\/tr><\/thead><tbody><tr><td>Subject<\/td><td>Subject<\/td><td>text<\/td><td>yes<\/td><\/tr><tr><td>Description<\/td><td>Description<\/td><td>rich text<\/td><td>yes<\/td><\/tr><tr><td>Product<\/td><td>Product<\/td><td>product picker<\/td><td>no<\/td><\/tr><tr><td>Reason<\/td><td>Topic<\/td><td>reason picker<\/td><td>no<\/td><\/tr><tr><td>Urgency<\/td><td>Urgency<\/td><td>urgency picker<\/td><td>no<\/td><\/tr><tr><td>Order<\/td><td>Order<\/td><td>text<\/td><td>no<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Two things worth noting:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>The reason field&#8217;s default label is &#8220;Topic&#8221;.<\/strong> The list itself is called Reasons. Rename the label here if that confuses your clients &#8211; the two are separate.<\/li>\n\n\n\n<li><strong>Subject and Description are always on and always required<\/strong>, whatever the checkboxes say. They become the ticket&#8217;s title and body, and a ticket cannot exist without them.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">The other four built-ins can be switched off. Their type cannot change &#8211; the badge is telling you a fact, not hiding an input.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Adding your own fields<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Add a row and pick a type: text, number, email, long text or dropdown.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For a dropdown, fill <strong>Options<\/strong> with one choice per line, written as <code>value:Label<\/code>:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>refund:Refund request\nbilling:Billing question\nother:Something else\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">The part before the colon is stored; the part after it is what the client sees. Three things to expect from custom fields:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Switching a field off stops new answers being stored<\/strong> but leaves everything already collected untouched.<\/li>\n\n\n\n<li><strong>Deleting a row does not delete past answers.<\/strong> They stay on the tickets that already have them.<\/li>\n\n\n\n<li><strong>Custom fields do not appear in the ticket editor&#8217;s details box<\/strong>, which shows only agent, urgency and order. Reading them back needs a developer, or a plugin that displays custom fields.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">The embeddable form is different<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The embeddable form &#8211; the one you can put on another website entirely &#8211; has its <strong>own fixed list of fields<\/strong> and ignores everything on this screen. Custom fields and switched-off built-ins do not reach it. See the <a href=\"https:\/\/nirohelp.com\/docs\/developers\/embedding-the-ticket-ui\/\" target=\"_blank\" rel=\"noopener\">Developers<\/a> section.<\/p>\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":[5],"class_list":["post-21","nirohelp_doc","type-nirohelp_doc","status-publish","hentry","nirohelp_topic-ticket-management"],"_links":{"self":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_doc\/21","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=21"}],"wp:term":[{"taxonomy":"nirohelp_product","embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_product?post=21"},{"taxonomy":"nirohelp_topic","embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_topic?post=21"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}