This article covers these topics:

• Introduction to sample fields
• Managing sample fields
• Using sample fields within projects
• List of Apple device types

Introduction to sample fields

Sample fields define useful information about the respondent. You can add custom sample fields as required. However, there are several  available by default. All these fields can be used within the project, as conditions to control the route each respondent takes through the survey. Some sample fields are detected automatically from respondent's device; these are available by default, and some of them are not modifiable. See the table below for details.

The default sample fields are as follows:

Managing sample fields

To manage sample list fields, when you have the list open click edit sample fields above the list. This presents a list of your custom fields you have created (on the left) and the system default sample fields (on the right). You can control the visibility of both the default sample fields and your custom fields, and you can add or remove custom fields as required.

You can click the eye icon to toggle each field's visibility on or off, this determines if the field is shown in the respondent list or not. The username field is always visible and cannot be hidden.

Adding sample fields

You can always add sample fields as needed. These are always modifiable, and exist only in your dashboard.

To add a sample field:

1. Click add a field.
2. In label, enter a name for the field.
3. In the adjacent drop-down list, select the field type, according to the type of information you want the field to hold (number, string, date, time or date time).
4. In alias, enter an alias (a label to be used to refer to the field in scripting and reports).
5. To make the field visible to the project, and in reports, select visible.
6. Click add.

Editing and deleting sample fields

In the list of custom fields, you can change the visibility of each, as well as the name, the type  (number, string, date, time or date time). Click save changes to apply any edits you have made.

You can also delete a field you no longer need. In the list of fields, hold the mouse pointer over the field you want to delete, then click delete (the bin icon).

Adding and editing sample field values

Once you have added a sample field, you can add values for each respondent in order to use these values within your projects. There are two ways to achieve this:

• Single add/edit: in the respondent list, click the respondent and select the action edit. You can then manually enter the field values for the respondent.

• Bulk import from a CSV file. Click update sample field(s), select the sample fields you want to update and then click download CSV. Enter the data into the CSV file and then import the file by clicking choose file, selecting the file, and then upload CSV.

Using Sample Fields within projects

If you have built a profile for your respondents and have sample fields that help you identify them, you may want to route the questionnaire accordingly. In this situation, you can use both default and custom sample fields within the routing logic of any of your projects.

Reading Sample Fields

The following function reads the value of the sample field. You can use this function as a condition in your script.

For more information on how to use sample fields within a script please see Conditions

Apple device types

The device type field returns details of the device model used by the respondent. iOS devices return things like "iPhone4,1" (see the list below) while Android devices return a model name or number. The list of  Apple devices is as follows: