CREATEGOOGLEDOC formula

Lido's =CREATEGOOGLEDOC() formula lets you build a PDF document by merging your spreadsheet data into a Google Docs template, which is then exported into the final PDF.

=CREATEGOOGLEDOC(credential, template_link, new_file_name, output_cell, [make_public]

1. Create a Google Docs template

First, note the data columns you would like to include in your template. In this example, we'll use all four, but you can use any number of them. If you would like to insert an image into the template, you should have a column with links to the image on your Google Drive. Images must be on your Google Drive, viewable by anyone with the link, less than 50MB, cannot exceed 25 megapixels, and must be in PNG, JPEG, or GIF format.

Now, create a template file in your Google Docs account. This should be the account you want to host the final PDF file. Note that it cannot be saved as a .docx file: it must be a native Google Doc. For the text columns that we want to insert, enter {{column name}} in all the places you want that data to show up. It can be in as many places as you want. The [@column name]notation, familiar from STRINGTEMPLATE, works here as well.

If you have an image to replace, like in this example, insert a placeholder image for CREATEGOOGLEDOC to replace with your data's image. Make sure to resize the placeholder to the size you would like the final image to be. Then, set the alt text for the image to be the name of the image link column in your spreadsheet:

2. Setting up the CREATEGOOGLEDOC formula

Now you're ready to start with CREATEGOOGLEDOC. Start your new CREATEGOOGLEDOC Computed Column by selecting a cell directly to the right of your table and typing =CREATEGOOGLEDOC(. If you don't have a Drive credential set up in Lido already, you can create one right now by clicking the "Add Credential" button and completing the authentication flow.

Once you have created a Drive credential, it will be placed into CREATEGOOGLEDOC as the first argument.

The next argument is the link to the template you want to use. Lido's dropdown suggestions make it easy to find and select your Google Doc template using the Google File Picker. Once you type a comma after the Credential argument, you will be prompted to select a file. Click the button, and either browse for your template file, or search for the name using the box at the top of the pop-up.

We only have two more required arguments to CREATEGOOGLEDOC: the new file name for your file, and the output cell. The former can be whatever you would like (and can even come from another Computed Column). The output cell is where CREATEGOOGLEDOC will place the link to the finished PDF file after it has been created in your Google Drive. If there is an error, it will instead output error information to this cell. We're about to create a Linked Column to the right of the CREATEGOOGLEDOC column to store these output values; for now, just enter the cell directly to the right of your CREATEGOOGLEDOC formula (in our example, that's F2). Our CREATEGOOGLEDOC formula now looks like this:

=CREATEGOOGLEDOC(<Google Drive Credential>, "https://docs.google.com/document/d/id...", "New File Name", F2

If you want the output PDF to be publicly-accessible with the link, then you can hit Enter and submit the formula. If not, you can enter false for the optional make_public argument.

Finally, we want to add a Linked Column to hold the status values. Mouse over the right of your table, select the add column icon, and select "Add Linked Column". Select the ID column you would like and hit "Save".

That's it! Your CREATEGOOGLEDOC formula is now ready to use.

To try it out, right-click on one of the CREATEGOOGLEDOC cells and click "Run action". If everything worked, you should see success appear in the Linked Column next to the formula you ran, and a PDF file with the name you set should appear in your Google Drive, with the link pasted in the adjacent Linked Column cell. Otherwise, you will see an error appear. Once the error has been fixed, try running the formula again to test it out.


What’s Next

Automate your CREATEGOOGLEDOC column, or send the Google Doc as an email attachment: