Menu Close Menu
Menu
  • 0
    • Number of items in cart: 0

      • Your cart is empty.
      • Total: $0.00
      • Checkout
  • Pricing
    • Purchase Options
    • Individual Extensions
  • Support
    • Documentation
    • Log a Support Ticket
  • Your Account
    • Register
  • Blog

How to add Ticket Form Fields

How to add Ticket Form Fields

Customise your submission form to capture the data you need

Perhaps the default fields created during install are not enough and you need to capture more information when a customer submits their ticket.

Adding (and editing) fields for a submission form is very easy.

From the Tickets -> Submission Forms menu page, select to either edit an existing form, or create a new one.

Adding a new Form Field

From within the Edit Form screen, provide the following information for your new field within the Add a New Field meta box:

  • Label
    This will be the label for the field when displayed on your form
  • Description
    If you want to display a description for your field, enter it here (optional). Select After Label to display the description after the field label but before the input field, or After Field to display the description after the input field
  • Type
    The type of field you select will determine which options you have for the field.
  • Required
    Make this a required field. The form cannot be submitted if the field is not completed
  • Label Class
    Enter a custom CSS class you want to apply to the label element for this field (optional)
  • Input Class
    Enter a custom CSS class you want to apply to the input element for this field (optional)
  • Maps to
    Certain fields can be mapped to specific ticket fields. For example a text input field you are using as a Subject field, can be mapped to the ticket title field and a textarea or Rich Text Editor field can be mapped to the ticket content field. Each mapping can only be used once per form

Dynamic Options

Depending on the type of field you selected, more options may become available:

  • Enable KB Articles Ajax Search?
    If this option is selected for your field, once the customer has entered data into the field and focus moves to another element, an ajax search will be performed and potential KB Article solutions will be presented to the customer
  • Options
    Displayed when the chosen field type is a select, checkbox or radio input. Enter the options that the customer can choose from (one per line)
  • Multiple Select?
    Displayed when the chosen field type is a select input. Enabling will render a select list where multiple options can be selected
  • Initially Selected?
    For checkboxes, you can select this option to have it checked by default when the form is loaded
  • Searchable?
    If the field type is a select field, you can choose to enable the customer to search the available options. Useful for select fields with many available options
  • Placeholder
    For a number of different field types you can set a placeholder here
  • Hide Label?
    Choose to hide the field label. Perhaps use a placeholder instead

Once you have entered all the relevant information for your new field, click Add Field and the field will be added to your form and visible within the main window. You can now use the drag handle icon to place your field into the required position within the form.

When your customers submit a form, your new field will be presented. The data they input into the field will be visible by clicking the View Form Submission Data link which is displayed within the Original Ticket meta box.


Was this article helpful?

We're working hard to ensure we provide you with useful and relevant documentation to help you get the most out of KB Support.

Please take a moment to let us know if you found this article helpful.

How to add Ticket Form Fields

Perhaps the default fields created during install are not enough and you need to capture more information when a customer submits their ticket. Adding (and editing) fields for a submission form is very easy. From the Tickets -> Submission Forms menu page, select to either edit an existing form, or create a new one. Adding a new Form…
KB Article rating: 5.0 based on 1 ratings
FAQs Submission Forms Last updated: 28/03/2017

Published by Cristian Raiber

Posts by Cristian Raiber

Post navigation

Previous

Advanced Settings for Ratings and Satisfaction

Next

Configuring Knowledge Base Integrations

Contact Details

  • Follow us on Twitter
  • Like us on Facebook
  • Fork us on GitHub

Developer Resources

Plugin Boilerplate

Trello Board

GitHub Repository

Ratings & Satisfaction Docs

  • Configuring Ratings and Satisfaction
  • Advanced Settings

Email Support Docs

  • Plugin Requirements
  • Configuring Email Support
  • Creating New Tickets
  • Replying to Closed Tickets
  • Anonymous Replies in Email Support
  • HTML Emails Tags
  • Email Commands
  • Defining IMAP Flags

KBS REST API Docs

  • Using the REST API
  • Tickets REST API Route
  • Replies REST API Route
  • Articles REST API Route
  • Agents REST API Route
  • Customers REST API Route
  • Companies REST API Route
  • Forms REST API Route
  • Form Fields REST API Route
  • Ticket Categories REST API Route
  • Ticket Departments REST API Route
  • Ticket Source REST API Route

Article Categories

  • Configuration
    • Advanced
    • Getting Started
  • Developer Docs
    • Constants
    • Hooks
  • Extensions
  • FAQs
© 2023 KB Support. All rights reserved.
  • Blog
  • Shop
  • Support
  • Privacy Policy
  • Discount Code