Skip to main content

Open Document Template with a Button

Add a Button field with a URL formula that opens a Document Designer template filled with the current record.

Written by Peter Novosel

A Button field can open a Document Designer template filled with the current record. The button uses a URL formula built from your Workspace ID, the template ID and RECORD_ID().

Example: the risk team prints a Vendor Assessment Report for a vendor many times a week. They add a button called Print Assessment to the Vendors table. One click on a vendor record opens the report, filled in and ready to print.

Plan Availability

All plan types.

Permissions

Administrators and Solution Managers add and set up Button fields. Any member who can view the record can select the button.

Platform

Web

Related Reading


Create the template

Create and save the template in Document Designer for the table. See Document Designer: generate a PDF from a record.


Find the template ID

The template ID is read once from your browser's developer tools.

  1. Open the developer tools: F12 on Windows, or Option + Command + I on a Mac.

  2. Select the Network tab. If it lists requests, select Clear.

  3. In SmartSuite, select the arrow next to the table's name and open the template the button will use.

  4. In the Network tab, select the request that begins with ?account=.

  5. In its headers, find document_design= and copy the value after it. That value is the template ID.


Add the Button field

  1. In the table, add a field of type Button. Name it, such as Print Assessment.

  2. Set the action to Open URL and choose URL Formula.

  3. Select Edit Formula.


Write the formula

Paste this formula:

CONCAT("https://document-designer.smartsuite.com/export?account=ACCOUNT-ID&document_design=DOC-DESIGN-ID&record=", RECORD_ID())

Replace the two placeholders:

  • ACCOUNT-ID: your Workspace ID, the 8 characters after app.smartsuite.com/ in the address bar.

  • DOC-DESIGN-ID: the template ID you copied.

Check that the editor shows no error. Select Apply, then Update Field.


Test the button

  1. Open any record in the table, such as a Tier 1 vendor.

  2. Select the button. A new tab opens with the template filled with that record, in print preview.

Note: If the button opens an error page, check the Workspace ID and the template ID in the formula.


Frequently asked questions

Where do I find my Workspace ID?

It is the 8 characters after app.smartsuite.com/ in the address bar.

Can I show the button only on some records?

Yes. Add a display rule in the record's page settings that shows the Button field when other fields hold certain values. See Conditional Record Fields.

What does RECORD_ID() do in the formula?

It adds the current record's ID to the address, so the template opens filled with that record.

The button opens an error page. What do I check?

Check the Workspace ID and the template ID in the formula. Both must match your workspace and the template.

Need more help? Ask the SmartSuite Community, where builders, administrators and the SmartSuite team answer questions about building on SmartSuite. For your account, billing or data, select the chat button in the lower-right corner of SmartSuite to reach support.

Last verified 1 Nov 2026.

Did this answer your question?