Fields Editor
Introduction to the new Fields Editor
The Fields Editor is where you define the data structure for your document templates. This completely redesigned interface allows you to visually create and organize your data fields without needing to understand JSON schema or other technical formats.

Getting Started with the Fields Editor
To get started with the fields editor, select the custom data source option.
When creating a new template, you have three ways to set up your fields:
Start from scratch: Manually define each field one by one.
Paste a JSON schema: Copy and paste an existing JSON schema to quickly set up your field structure.
Upload a JSON schema file: Import a JSON schema file directly.

Field Types
The Fields Editor supports seven fundamental field types, covering all common data needs:
1. String
For text data such as names, descriptions, addresses, and other textual information.
2. Number
For any numerical values such as prices, quantities, percentages, and measurements.
3. Boolean
For true/false or yes/no values.
4. Date/Time
For timestamps, due dates, calendar events, and other time-related information.
5. Objects
For structured data containing multiple related properties. For example, a "customer" object might contain name, email, and address properties.
6. Collections
For arrays or lists of objects with the same structure. For example, invoice line items, where each item has properties like description, quantity, and price.
7. Lists
For simple arrays of primitive values (strings, numbers, booleans, or dates). For example, a list of tags, phone numbers, or dates.
Creating Simple Fields
Adding a simple field (string, number, boolean, or date) is straightforward:
Click the "Add Field" button.
Enter a name for your field.
Select the field type from the dropdown menu.

Creating Complex Fields
Objects
To create an object field:
Click the "Add Field" button.
Enter a name for your object.
Select "Object" as the field type.
The object will appear in your fields list with an expandable/collapsible interface.
Click the "+ Add Object Field" button within the object to add properties.
Add as many properties as needed, of any supported type.

Collections
Collections are similar to objects but represent arrays of objects:
Click the "Add Field" button.
Enter a name for your collection.
Select "Collection" as the field type.
The collection will appear in your fields list with an expandable/collapsible interface.
Click the "+ Add Collection Field" button within the collection to add properties that each item will have.
Define the structure of each item in the collection.

Lists
For simple arrays of primitive values:
Click the "Add Field" button.
Enter a name for your list.
Select "List" as the field type.
Select the type of items in the list (string, number, boolean, or date).

Importing Field Definitions
For users who already have a data structure defined in JSON Schema:
Click the "Import" button.
Choose either "Paste JSON Schema" or "Upload JSON Schema File".
If pasting, enter your JSON Schema in the text area and click "Import".
If uploading, select your file and click "Open".
The Fields Editor will parse the schema and create your field structure.
Testing Your Field Structure
Before finalizing your template, it's a good idea to test your field structure:
Use the "Preview" feature with sample data.
Check that complex fields like collections and objects display as expected.
Make adjustments as needed.
In the next section, we'll explore how to connect your template directly to Airtable, allowing Documint to automatically import your field structure.
Last updated
Was this helpful?