Overview

Many areas of Kayako Classic prompt customers for information, but sometimes, the standard questions don't get you all the details you're after. For those situations, Kayako Classic has custom Fields, which you can add to most customer-facing forms to request whatever information your team needs.

Custom Fields allow you to expedite your support processes by cutting down on the back and forth with your customers. Meanwhile, they let you capture and store useful customer information to help you deliver exceptional support experience.

This article explains how custom Fields work in Kayako Classic, where they're available, and how to create them.

Information

Understanding how custom Fields work

First, every Custom Field belongs to a Group, which you'll use to organize related Fields and control the location in Kayako Classic they are displayed. For each Group, you'll add a Title and select a Location:

• User profile – Store additional customer details on their user profiles. Users will be prompted to fill in these Fields when registering on your support center, and staff can fill them when inserting or managing users from the staff control panel.
• User organization profile – Capture information about user organizations. These Fields will be visible and editable by users when they fill in their organization details on their support center profile. Staff can also edit these Fields under the Organizations section in the staff control panel.
• Live chat (before chat) – Ask for specific details before letting customers start a chat conversation.
• Live chat (after chat) – Add questions to display in the live chat window when a conversation is completed. Use them to solicit specific ratings, feedback, etc.
• Staff ticket creation – Create custom Fields on the form your staff will use when creating a new ticket from the staff control panel. These Fields will not be visible to your customers.
• User ticket submission – Prompt your users for specific information when they're creating a new support ticket on the support center.
• Staff and end user ticket creation – Select this location to create a Group of Fields that will appear to both your staff and your end users, when they're creating new support tickets.
• Ticket time tracking/billing entry – Track detailed billing information by adding custom Fields to the Billing ticket tab in the staff control panel.
  
  NOTE: Once a custom Field Group is created; you cannot change its location.

When you've created a field Group or two, you can start to add the Fields themselves. Kayako Classic supports a variety of different field types:

• Text – Small, single-line text box that allows users to enter a short string of text.
• Text area – Larger text area, spanning multiple-lines, that allows users to enter larger blocks of text.
• Password – Text box that masks any values entered, for security.
• Checkbox (multiple choices) – List of options with checkboxes next to them. Users can select multiple options.
• Radio Buttons (single choice) – List of options with radio button selectors. Users can select one option.
• Drop-down select (single choice) – List of options in a dropdown menu. Users can select one option.
• Multi-selection menu (multiple choices) – List of options in a menu. Users can select multiple options.
• Linked select (multiple choices) – Drill down menu that takes users through nested options, where they can make multiple selections.
• Date – Pop-up calendar that users can select a date from.
• File – Field where users can upload individual files.
• Custom – Blank field container that allows you to supply your own HTML for a form field.
  
  After you've selected a Field type, you'll be able not only to define the field's options but also configure its behavior. You can control whether it's editable by users or just by staff. You can make it required. You can restrict the values it will accept by matching them to a regular expression. You've got lots of control here.

Inserting a new custom Group and field

You can use custom Fields to serve a lot of different purposes. We'll look at a common example – adding Fields to the ticket submission form to capture the user's product type and serial number. You'll need an administrator account with the Custom field Groups and Custom Fields permissions to execute the following instructions:

1. Log in to the admin control panel.
2. Click Custom Fields and then Groups in the sidebar.
3. Click the New button in the upper right.
4. Add a Title for your new Group, such as Product Details.
5. From the Custom field Group location dropdown, select Staff and end user ticket creation.
   
   
6. Since you want customers to be able to use these Fields, set Group Visibility to Public.
7. If you have multiple Groups in the same location, you can use Display order to control the order in which they appear.
8. Once done, click the Insert button to create your Group.
9. Now we're ready for the Fields themselves. Click Fields in the sidebar.
10. Click the New button.
11. We'll start with our Product field. Select drop-down select so we can limit users to the list of products we define.
12. Click the Next button.
13. From Custom field Group, select the Product Details Group to add it to the Field Group we just created.
14. Add a descriptive name in Field Title in this case Product.
15. In Field description, you can provide a little bit of explanatory text that will appear below the field.
16. In the Field Options list, enter the options your users can choose from.
17. If you need more than the default eight spots, click the Insert button above the list.
    
18. Switch to the Options tab, up top.
19. Here, let's set Required field to Yes to make our new Field mandatory.
20. And for Field editable by end users, select Yes, to let our customers make changes.
21. Click the Insert button to save your new Field.
22. Next, add a Serial Number field. Click New.
23. From Custom field Group, select the Product Details Group.
24. Select Text for the Field type, and click Next.
25. In Field title let's go with Serial Number.
26. Add a quick bit of help text to the Field description.
27. Switch to the Options tab.
28. Let's leave this field as optional, but make sure that Field editable by end users is set to Yes.
29. Click Insert to save the field.

Your users will now see the Product Details section on the submission form whenever they go to create a new ticket from your support center.