Start a conversation

Adding Custom Fields for Conversations, Users, and Organizations

Overview

The more information you gather about your customers and the problems they face, the easier it is to help them. To make that simpler, Kayako has options for creating custom fields that you can add to forms, organization pages, and user profiles, enabling you to ask for and store whatever information you need.

 


 

Information

Kayako gives you lots of flexibility for how you collect information by providing a dozen different field types. Each one is designed to capture information in a different format. The table below will explain the different field types:

Text Small, single-line text boxes that allow users to enter a short string of text.
Multi-line text Larger text areas, spanning multiple-lines that allow users to enter larger blocks of text.
Radio Buttons (single choice) List of options with radio button selectors. Users can select one option.
Dropdown list (single choice) List of options in a dropdown menu. Users can select one option.
Checkboxes (multiple choices) List of options with checkboxes next to them. Users can select multiple options.
Numerical input A small text box that will permit users to enter only whole numbers.
Decimal input A small text box that will permit users to enter only numbers or decimal values.
Yes/No toggle A toggle switch that allows users to select 'Yes' or 'No.'
Cascading select Drill down menu that takes users through tiered options, where they can make multiple selections.
Date A pop-up calendar that users can select a date from.
Regular expression A text box that will only permit users to enter values that match the criteria you define with a regular expression.

Now that you know the types of fields you can create let's talk a little bit about where and how you can put them to good use.

There are three types of custom fields, and each is used for different things:

  • Conversation fields — You can add conversation fields to forms. Any conversation that uses that form will display these conversation fields in the sidebar. You can choose to make these fields visible and editable by your customers when they're starting a conversation or when viewing their open conversations from the Help Center. This makes them an excellent tool for collecting exactly the information you need, from the moment a conversation is created.
  • Organization fields — You can use organization fields to customize the type of data you track for the organizations you support. Any enabled organization fields will appear in the sidebar when you're viewing an organization page.
  • User fields — You can use user fields to add additional detail to the user profiles of both staff and customer users. You can choose to make these fields visible and editable by your customers, as well.

In addition, all three types of custom fields open up worlds of possibility for building automations:

  • You could create a custom conversation field for the product model, and then create a trigger that automatically assigns each conversation to whoever is most knowledgeable on that model.
  • You could add a custom organization field that tracks which subscription tier they belong to, and then build an SLA for each tier.

The list could definitely go on. But for now, let's have a look at the steps for actually creating your own custom fields.

Creation and Configuration

Creating Custom Fields

Creating custom fields in Kayako follows almost exactly the same steps, whether you're creating conversation, user, or organization fields. There are two small differences:

  • With conversation fields, you can opt to make them required for support agents.
  • With conversation and user fields, you can opt to make them editable by customers, in addition to your support team.

Related Articles:

Back to top


 

Prerequisite

  • To add custom fields in Kayako, you will need an administrator account with either the 'Manage conversation fields' or 'Manage custom user and organization fields' permissions, depending on the type of field you're creating.
  • You'll need to be on the Growth plan or higher to work with custom conversation fields.

 Back to top


 

Solution

To create a field:

  1. Sign in to Kayako and go to the admin area.
  2. Depending on the kind of field you're creating, click either Conversation fields, Organization fields, or User fields on the sidebar.
  3. Here, you'll see a list of system and custom fields that have been created already. Click the New field button to start customizing a new one.

    Fields_Create.jpg
  4. Choose the type of field you'd like to create. (See the Diagnosis section above for the description of each type.)

    mceclip0.png
  5. In the Field title text box, enter a descriptive title for the field.

    NOTE: This is only an internal title — it will not be visible to your customers.
  6. If you're creating a conversation field, you can make it mandatory for your agents when updating or resolving a conversation. Just check the Creating, replying to, or updating a conversation and/or the Resolving a conversation box.

    mceclip1.png
  7. Check the Customers can see this field box to make the field visible to your customers.
  8. In the 'Field title for customers' text box, enter a label for the field.
  9. In the 'Field description for customers' text box, enter a brief description of the field.
  10. You can make conversation and user fields usable by your customers as well. Check the Customers can edit this field box to enable your customers to use the field, and the 'This field is required for customers' box to make it mandatory.

    mceclip2.png
  11. From here, things will vary based on the type of field you're creating. If you see additional configuration options, fill them in. If there aren't, your work is done.
  12. When you've finished, click the Save button.

 

Back to top


 

Confirmation

Once your field is created, any new field you create will be available to add and edit on either forms, organization pages, or user profiles. They'll also be available when building SLAs, and other automations. If you're on the Growth, Scale, or Enterprise plans, and you've enabled multiple languages for your Kayako, you can add translated names, descriptions, and values for your fields.

 

Back to top

 

 

Choose files or drag and drop files
Was this article helpful?
Yes
No
  1. ATLAS

  2. Posted

Comments