People Variables

The variables in this article are used to reference the different people in your project and automatically fill out documents with the data entered in Build.

The following tables are available in this article:

To set up roles for people in your project, see the Company Setup section in the General Settings article.

Contractor and Architect Variables

Use the variables from the table to generate documents with necessary information about people in your project. For example, you can populate contact's name or phone number.

Variables Description PCO RFQ COR OCO SCO
{x.name} Returns the company name of the contact
{x.contact.name} Returns the contact name of the contact
{x.contact.phone} Returns the contacts' first phone number from their Autodesk ID profile
{x.contact.email} Returns the email of the listed contact from your general settings
{x.contact.taxId} Returns the contact's tax ID

Replace x with the type of person to be returned, one of the following:

Owner Variables

Use the variables from the table to populate information about an owner in generated documents. For example, you can add owner's name or phone number.

Variables Description PCO RFQ COR OCO SCO
{owner.name} Returns the company name of the owner
{owner.contact.name} Returns the contact name of the owner
{owner.contact.phone} Returns the owner's first phone number from their Autodesk ID profile
{owner.erpId} Returns the owner's erp ID
{owner.taxId} Returns the owner's tax ID
{owner.trade} Returns the owner's trade
{owner.contact.email} Returns the owner's email address from the general settings
Note: Owner information must be entered in Project Admin on the General tab in the Companies Setup section.

Recipient Variables

Use the variables from the table to generate documents with information about recipients.

Note: For Main Contract, Budget Payment Application, COR, and OCO, following variables return the Owner details' contact's data. For Contract, Cost Payment Application, PCO, RFQ, and SCO, these variables return the Supplier details' contact's data.
Variables Description
{x.recipient.name} Returns the full name of the recipient
{x.recipient.firstName} Returns the first name of the recipient
{x.recipient.lastName} Returns the family name of the recipient
{x.recipient.email} Returns the email address of the recipient
{x.recipient.phone} Returns the recipient's first phone number from their Autodesk ID profile
{x.recipient.jobTitle} Returns the job title of the recipient of the change order or contract that comes from the user’s Autodesk ID profile setting
{x.recipient.taxId} Returns the tax ID of the recipient

Where x is one of the following:

Recipient, Creator, and Purchaser Variables

Use the variables from the table to generate documents with information about people in your project. For example, you can populate the name of the company that received the change order or the full name of the recipient of the contract. You can use the search at the top of the tables to narrow down results in the tables.

Variables Description Contract PCO RFQ COR OCO SCO Cost Payment Application
{x.y.email} Returns the email address of the recipient of the change order, contract, or cost payment application
{x.y.firstName} Returns the first name of the recipient of the change order, contract, or cost payment application
{x.y.lastName} Returns the family name of the recipient of the change order, contract, or cost payment application
{x.y.name} Returns the full name of the recipient of the change order, contract, or cost payment application
{x.y.jobTitle} Returns the job title of the recipient of the change order or contract that comes from the user’s Autodesk ID profile setting
{x.y.company.address.*} Returns the address of the company that received the change order or contract
{x.y.company.name} Returns the name of the company that received the change order, contract, or cost payment application.
{x.y.phone} Returns the recipient's first phone number from their Autodesk ID profile
{x.y.company.erpId} Returns the ERP Partner Company ID of the company that received the change order or contract
{x.y.company.taxId} Returns the tax ID of the company that received the change order or contract
{x.y.company.phone} Returns the phone number of the company that received the change order or contract
{x.y.company.description} Returns the description of the company that received the change order or contract

Where x is one of the following:

Where y is one of the following:

Notary Variables

Use the variables from the table to populate information about a notary in your generated documents. For example, you can add the name of the company that received the change order or the full name of the recipient of the contract.

Variables Description
{notary.erpId} Returns the notary's erp ID
{notary.taxId} Returns the notary's tax ID
{notary.name} Returns the notary's name
{notary.originalName} Returns the notary's original name
{notary.description} Returns the notary's description
{notary.phone} Returns the notary's phone number
{notary.trade} Returns the notary's trade
{notary.category} Returns the notary's category
{notary.contact} Returns the notary's contact