# Custom fields

Store extra details with each testimonial, such as company size or country, and show them on widgets, Wall of Love pages and share pages.

Custom fields are your own details stored with each testimonial, such as company size, industry, the product someone bought or where they live. You define them once for the project, collect their values through forms, the inbox and imports, and choose where visitors see them.

## Field types

When you create a field, you pick one of eight types:

| Type           | What it holds                                                                                                                                             |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Short Text** | One line of text.                                                                                                                                         |
| **Long Text**  | Several lines of text.                                                                                                                                    |
| **URL**        | A web address starting with `http://` or `https://`, shown as a link.                                                                                     |
| **Checkbox**   | Yes or No. **Hide When Unchecked** keeps a No off your cards.                                                                                             |
| **Dropdown**   | One of the **Options** you list.                                                                                                                          |
| **Number**     | A whole number, or a decimal when you turn on **Allow decimals**. You can set a **Minimum value**, a **Maximum value** and **Allow negative numbers**.    |
| **Country**    | A country picker. **Collect region / state** can also ask for a region: a dropdown for the US, Canada, Australia, the UK and India, a text box elsewhere. |
| **Currency**   | An amount with its currency. Set a **Default currency**, and **Limit to specific currencies** if you want.                                                |

![The Add Custom Field dialog with the Field Type menu open on its eight types: Short Text, Long Text, URL, Checkbox, Dropdown, Number, Country and Currency](https://assets.retestimonial.com/app-statics/help/shots/projects-custom-field-types.3594b530.webp)

Every field also has **Required** (people must fill it in) and **Show Label** (show the field's name next to its value on cards). You can't change a field's type after you create it.

## Where the values come from

- **Forms.** A field appears on a form only when you switch it on for that form's **About You** or **About Company** page. Each form can give it its own label, placeholder and **Required** setting.
- **The inbox.** The **Add a text testimonial** and **Add a video testimonial** dialogs, and the **Edit** window of any testimonial, have a **Custom Fields** section.
- **Imports.** When you import a CSV, Excel or JSON file, you map columns to your fields. See [Custom fields](/help/import/import-file-columns-and-formats#custom-fields) in "Import file columns and formats".

To see a testimonial's values in the inbox, click **Show more** on its card.

## Where the values appear

- **Widgets:** hidden until you turn them on. In the widget builder, open **Custom Fields** on the **Design** tab and switch on **Show custom fields**, then choose the **Position** and the **Fields to Show**.
- **Wall of Love:** shown by default, below the author. On the wall's **Design** tab, **Custom Fields** sets the **Display Position** (or **Hidden**) and which fields show.
- **Share pages:** every field with a value is shown while **Show custom fields on share pages** is on. It's on by default, under the **Share Pages** tab of your project settings. Turn it off if your fields hold internal details that shouldn't be public.
- **Emails:** in a form's **Notifications** tab, **Merge Tags** lists `{custom_fields}` (all of them) and one `{cf:…}` tag per field for your email templates. The **Custom Fields** tab shows each field's tag too, with a button to copy it. See [Set up the emails a project sends](/help/account/set-up-project-emails#merge-tags).
- **Translations:** **Short Text** and **Long Text** values are translated along with the testimonial. See [Translate testimonials](/help/manage/translate-testimonials).
- **Project webhooks** (Premium and Business) send each field's label and value with the testimonial.
- **Proof Intelligence** reads your fields, with their labels, when it analyzes a testimonial. See [Proof Intelligence](/help/manage/proof-intelligence).

Numbers and amounts are always written the US English way, such as 1,250.5.

## Countries as flags

A **Country** field can show the country's **Name**, its **Flag** or **Flag + name**. You choose separately for each widget and wall (the **Display as** menu under the field) and for share pages (**Country field display**, under the **Share Pages** tab of your project settings).

## Plans and permissions

Custom fields are included in Pro, Premium and Business. Each project can have 2 on Pro, 5 on Premium and 5 on Business. The **Custom Fields** tab shows how many you've used.

If your plan changes to one without custom fields, your fields and their values are kept, but widgets, walls, share pages and forms stop showing them and the inbox stops asking for them.

Only the workspace owner and the project's Admins see the **Custom Fields** tab and can create, edit or delete fields. Anyone who can edit testimonials can fill in their values.

## In this section

- [Add custom fields](/help/manage/add-custom-fields): create a field, collect it and show it.