> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/surveys/create-custom-fields-for-surveys.md).

# Create Custom Fields for Surveys

Custom fields are used with surveys to gather pieces of information about your partners. For example, if you frequently need to collect your partners' date of birth, you can create a birthday custom field using the *date picker* question type.&#x20;

You can also [find a custom field’s ID](#find-a-custom-field-id), which you need to retrieve, update, or delete a custom field via the API.

## Create custom fields

1. From the top navigation bar, select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[User profile]** → **Settings**.
2. On the right under *Program Settings*, navigate to the *Technical* section, and select [**Custom Fields**](https://app.impact.com/secure/advertiser/engage/fr/custom_fields.ihtml).
3. In the upper-right corner, select **Create Custom Fields**.
4. Complete the custom field information:
   * **Name:** Add a name to easily recognize this custom field when adding fields to a survey.
   * **Description:** Add a description for your custom field to describe the data representing the custom field. This description won't be visible to the partner.
   * **Display Type:** Choose the question type that would best capture the data for which you are looking. Refer to the *Display types reference* below.
5. Select **Save**.
   * You're now able to choose this custom field from the ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Drop-down menu]** when creating a survey.

{% hint style="success" %}
**Note:** You can also create custom fields when [setting up a new survey](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/surveys/create-a-partner-survey.md).
{% endhint %}

<details>

<summary>Display types reference</summary>

| Display type  | Best used for                                                                                                                                    |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Paragraph     | Open-ended questions that allow unique answers.                                                                                                  |
| Multi-select  | Questions that may include multiple answers. Respondents can select 1 or more options.                                                           |
| Dropdown list | Questions that require the user to select an option from a hidden dropdown menu with multiple answers. Respondents can select 1 or more options. |
| Single-select | Questions that require respondents to select only 1 option from a list.                                                                          |
| Date picker   | Questions that require a date as an answer.                                                                                                      |
| Number        | Questions that require a number as an answer.                                                                                                    |
| File          | Questions that require an attachment from the partner.                                                                                           |

</details>

<div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FTxGBstGvoM8EnsFvj49B%2FScreenshot%202026-04-24%20at%2011.27.32.png?alt=media&amp;token=7493dad7-14e4-4fc7-a52e-ed591ecabebd" alt="The create custom field screen shows the custom field options." width="375"><figcaption></figcaption></figure></div>

## Find a custom field ID

Every custom field has a unique ID. Use this ID to work with a specific custom field through the [custom fields API](https://integrations.impact.com/brand-api-reference/reference/surveys-and-custom-fields#custom-fields). The ID also helps you match survey responses from the API to the custom field each question uses.

1. From the top navigation bar, select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[User profile]** → **Settings**.
2. On the right under *Program Settings*, navigate to the *Technical* section and select [**Custom Fields**](https://app.impact.com/secure/advertiser/engage/fr/custom_fields.ihtml).
3. Optionally, search for the custom field by name in the *Name* field, or select **Display Type** to filter your custom fields by question type.
4. Copy the custom field's ID from the *ID* column.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/surveys/create-custom-fields-for-surveys.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
