> ## 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 form an integral part of your application form. 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) Help Centre article.
</Info>

### Field 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 the [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) list. <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 the [**Upload application file**](/api-reference/applications/upload-application-file) or [**Upload user file**](/api-reference/users/upload-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:<br /><br />`{`<br />  `"slug": {`<br />    `"B1": "valueB1",`<br />    `"C1": "valueC1",`<br />    `"B2": "valueB2",`<br />    `"C2": "valueC2"`<br />  `}`<br />`}`                                                                     |
| Text (single line)     | String      |                                                                                                                                                                                                                                                   |
| Text area (multi-line) | String      |                                                                                                                                                                                                                                                   |
| Time                   | String      | Must follow the following format: `00:00`                                                                                                                                                                                                         |
| URL                    | String      | Must begin with `https://`.                                                                                                                                                                                                                       |