Troubleshooting

This section provides solutions for common issues you might encounter while using the Documint app.

Errors

Error while fetching Airtable data

If you are getting this error and your template is built with variables, you will need to re-establish the Airtable connection. For that, just regenerate the PAT key and paste it into the deprecated Airtable Connection option in the integration settings.

With that done, regenerate the Generation Link or the Script, and you should be good to go!

Getting AUTHENTICATION_REQUIRED error when trying to create documents from Airtable

Airtable no longer uses API keys for API access. If you integrated in the past with an API key, you will need to replace it with a personal access token from Airtable.

This error is likely occurring because you have not provided a valid personal access token (PAT). Documint requires an Airtable PAT to access your data for document creation.

See Add your Airtable Personal Access Token on how you can create and add your Airtable PAT.

If you have already provided a PAT and your integration has stopped working, try regenerating your PAT and adding it to your Documint integration. If that does not work, try creating a new one with the required scopes and adding that one instead.

If you are still getting a 401 AUTHORIZATION_REQUIRED error, please contact Documint support.

PDF not attaching back to Airtable

This could be happening due to a scope missing in the PAT key. In this case, please edit the PAT key in Airtable and add the following scopes:

• data.records:read (to read your Airtable data)

• data.records:write (to potentially update records)

• schema.bases:read (to access your table structure)

Now, regenerate the PAT key, re-establish the connection with Documint, and regenerate the Generation Link or the Script.

If it doesn't work, please contact our Support Team.

Data not displaying

Getting [object Object] in my field

If you are getting the [object Object] error, it could be because you are trying to display an Object field directly. In this case, please choose the field in that object that you'd like to display

In case you are trying to display an image and are using the token for it, the way to go is to use the image element and pick the field from the list. Here is a helpful video:

If this is not the case, please contact support so we can assist.

Trouble with repeating elements

Looping over repeated elements is a common technical challenge users may face. We devote a whole section to troubleshooting in the List Operations page.

Nested data not displaying

When you have two or more levels deep of data you'd like to display, and even when having the token correctly and no data is being displayed for some reason, if it is a collection field, one option is to make a nesting.

A nesting is basically a loop within another loop. Here is a video that might help:

But if you'd like to display only one item of that list, here is how you can set this up:

1. The field is in a collection (an array of objects)

To access a specific field in a collection (array), use .[index].

Template

{{Books.0.Chapters.0.Title}}

Data

Result

1. The field is in an object

To access a field nested within an object, use a . .

Template

{{Books.Chapters.Title}}

Data

Result

Linked record displaying record ID

To display a field from a linked record, be sure to expand it in the Airtable Connection first and then drag the token from the linked record that you'd like to display.

[GIF] (drag linked rec token | preview rec ID | expand field in AT con | open linked rec fields in token pane | drag field token | preview)

If you need any assistance with displaying a field in another table, please contact support.

Design tips

Empty values in a list causing misaligned rows

If you are looping over a list of objects (collection), you need to place the repeating logic on the highest level element that will be repeating itself.

If, instead, you place the repeating logic in each of the columns that display your objects properties, each column ends up repeating itself independently. Consequentially, if any of the objects in your list are missing properties, some of the columns will lag behind the others, and the rows will no longer be aligned.

See the troubleshooting section for the list operations page for extended details on where to place the repeating logic.

Image not displaying in a loop

When there is an image for each item in the repeating list that you are displaying, and instead of printing the image, it's getting you a blank space. The way to work around this is to click the (x) and manually enter the image field. Which would look like [Image Field].0.[url]

Bottom border for each item in a list

Setting borders for a table can be challenging. If you want to add a bottom border for each item on your list and ensure it is correctly aligned, you should apply the bottom border to the column that contains the text element.

Different border width in same table

Applying borders at different levels of a table can make it look like some borders have different widths. This happens because they overlap. To fix this issue and make it look cleaner, you can collapse borders.

Text not appearing as it does in Airtable field

If you have a long text field in Airtable and have some formatting there, such as bold content, bulleted lists, URLs, line breaks, etc. You will need to set the text type of the token to Markdown. Here is how you can do that:

---

If you experience a problem not covered here, or the troubleshooting steps have not resolved your issue, please contact Documint support.