> ## Documentation Index
> Fetch the complete documentation index at: https://docs.goodgrants.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fields

> Field types and data types for the Good Grants API.

## Fields

Fields are the building blocks of your Good Grants setup. They collect information about applications, users, attachments, contributors, and referees.

Good Grants provides a wide range of field types you can use to collect exactly the information you need from applicants. Many field types include additional configuration options, such as file size limits or minimum and maximum word counts.

<Info>
  For a full list of field types and their configuration options, see the
  [Field types overview](https://help.goodgrants.com/hc/en-gb/articles/360001955095-Field-types).
</Info>

### Fields expected data types

### Fields expected data types

| Field                  | Type        | Notes                                                                                                                                                                                                                                               |
| :--------------------- | :---------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Checkbox               | Boolean     |                                                                                                                                                                                                                                                     |
| Checkbox list          | Array       | Options must exactly match the field value, not the label, including letter case. <br /><br />Example: `["Item 1", "Item 2"]`                                                                                                                       |
| Content                | String      |                                                                                                                                                                                                                                                     |
| Country                | String      | Accepts the two-letter country code from [this list](https://support.awardforce.com/hc/en-us/articles/360000237856-Two-letter-country-codes-in-fields). <br /><br />Example: `AU` for Australia                                                     |
| Currency               | Float       | Accepts a numeric currency amount value.                                                                                                                                                                                                            |
| Date                   | Date        | Accepts a date in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. <br /><br />Example: `2025-12-08T08:58:50Z` or `2025-10-08`                                                                                                            |
| Date and time          | Date        | Same as Date field.                                                                                                                                                                                                                                 |
| Drop-down list         | String      | Options must exactly match the field value (not label) including letter case.                                                                                                                                                                       |
| Email                  | String      | Must follow standard email format, for example [name@domain.com](mailto:name@domain.com).                                                                                                                                                           |
| File upload (single)   | JSON string | A JSON string containing two properties: `filename` and `data`. <br /><br />See [Upload an entry file](/api-reference/entries/upload-an-entry-file) or [Upload a user file](http://localhost:3000/api-reference/users/upload-a-user-file) endpoints |
| Numeric                | Float       | Accepts any numeric input.                                                                                                                                                                                                                          |
| Phone number           | String      | Must be a valid phone number in international format, including a leading `+`.                                                                                                                                                                      |
| Radio buttons          | String      | Options must exactly match the field value (not label) including letter case.                                                                                                                                                                       |
| Table                  | JSON string | Example: `{"slug": {"B1": "valueB1", "C1": "valueC1", "B2": "valueB2", "C2": "valueC2"}}`                                                                                                                                                           |
| Text (single line)     | String      |                                                                                                                                                                                                                                                     |
| Text area (multi-line) | String      |                                                                                                                                                                                                                                                     |
| Time                   | String      |                                                                                                                                                                                                                                                     |
| URL                    | String      | Must begin with `https://`.                                                                                                                                                                                                                         |