Plutio Logo
Product
Work AI
TemplatesPricing
Log inTry for free
My account
Sign up
My account
Menu

Product

PricingIntegrationsFeaturesTemplates
new
Changelog
new

Support

Community
On-boarding
Help centre
Contact usStatus

Resources

Stories & SetupsAlternativesComparisonsSolutionsFree toolsMagazine

Company

AboutIn the pressBrand assetsAffiliates

Platforms

API docs
iPhone & iPad
Android
Mac & Windows
Twitter
YouTube
Instagram
Linkedin

All powered by

AI that runs your entire business as if it were you

Proposals drafted, invoices chased, clients updated - ask, and it's done.

Learn more

Close
Log inTry for free
My account
Pricing

Product

Super Work AI

Support

On-boarding
Help centre
Contact usCommunity
Status

Resources

TemplatesAPI docs
AffiliatesStories & SetupsAlternativesComparisonsFree toolsMagazineIntegrations

Company

AboutIn the pressBrand assets

Platforms

iPhone & iPad
Android
Mac & Windows

Connect

Twitter
YouTube
Instagram
Linkedin
Try Plutio free
On this page
  • How to insert smart fields
  • When variables are replaced
  • Available variable categories
  • Workspace fields
  • Client fields
  • Proposal fields
  • Invoice fields
  • Contract fields
  • Project fields
  • Subscription fields
  • Receipt fields
  • Task fields
  • Form fields
  • Sender and person fields
  • Organizer fields
  • Other fields
  • Custom fields as variables
  • Conditional logic
  • Looping with each
  • Address fields
  • Smart fields in automations
  • What happens with empty variables
  • Tips and best practices
Contacts and CRM
  • Contacts overview
  • Creating and managing contacts
  • Contact detail page
  • Companies - creating and managing
  • Companies - company detail page
  • Contact custom fields
  • Linking contacts to projects
  • Contact activities and notes
  • Contact import and export
  • Smart fields (variables)
  • Show or hide text with if/else
  • Deactivating and reactivating contacts

Help Center / Contacts and CRM /

Smart fields (variables)

Smart fields are variables you insert into proposals, contracts, invoices, receipts, email templates, and automations that replace themselves with real data when the document is viewed or sent. Instead of typing a client's name, address, or invoice amount into every document manually, you insert a variable like client.firstName and Plutio fills in the actual value at render time.

How to insert smart fields

Inside any content block in the block editor, click the Variables button in the editor toolbar (the {x} icon). A dropdown opens showing all available variable categories for that document type. Click a category to expand it, then click the specific field you want to insert. The variable appears in your content as a highlighted tag.

You can also type {{ directly in the editor to trigger the smart field autocomplete. Start typing the field name and select it from the suggestions list.

Smart fields work in content blocks, intro blocks, email template bodies, and automation action fields. They don't work inside image blocks or signature blocks.

When variables are replaced

Variables are replaced at the moment the document is rendered for the viewer. For proposals, contracts, and invoices, the replacement happens when the client opens the document link. For emails, the replacement happens when the email is sent. For PDFs, the replacement happens when the PDF is generated.

If a variable has no data to fill (for example, the client has no phone number), the variable tag stays in the document as-is. You can use conditional logic to hide empty fields entirely (see the Conditional logic section below).

Available variable categories

Which categories appear in the dropdown depends on the document type. A proposal shows proposal, client, workspace, project, and other fields. An invoice shows invoice fields plus client, workspace, and other. The full mapping:

Document typeAvailable categories
ProposalProposal, Client, Workspace, Project, Other
ContractContract, Client, Workspace, Project, Other
InvoiceInvoice, Client, Workspace, Other
SubscriptionSubscription, Invoice, Client, Workspace, Other
ReceiptReceipt, Invoice, Client, Workspace, Other
FormForm, Workspace, Other
Email templateSender, Workspace, Other (plus entity-specific fields depending on the email type)
Automation actionAll connected entity fields from the automation's trigger and connections

Workspace fields

Workspace fields pull data from your business settings at Settings> General.

VariableWhat it renders
workspace.nameYour workspace/business name
workspace.emailPrimary business email
workspace.emailAltAlternative business email
workspace.phonePrimary business phone
workspace.phoneAltAlternative business phone
workspace.addressFull formatted address
workspace.address.streetAddress line only
workspace.address.cityCity/ State
workspace.address.zipCodePost/ Zip code
workspace.address.countryCountry
workspace.custom.FIELD_IDAny workspace custom field

Client fields

Client fields pull data from the contact or company assigned to the document.

VariableWhat it renders
client.nameFull name (first + last)
client.firstNameFirst name
client.lastNameLast name
client.emailPrimary email
client.emailAltAlternative email
client.phonePrimary phone
client.phoneAltAlternative phone
client.addressFull formatted address
client.address.streetAddress line
client.address.cityCity/ State
client.address.zipCodePost/ Zip code
client.address.countryCountry
client.company.nameCompany name
client.company.emailCompany email
client.company.phoneCompany phone
client.company.websiteCompany website
client.company.addressCompany full address
client.personIdClient's internal ID (useful for links and automations)
client.custom.FIELD_IDAny contact or company custom field

Proposal fields

Available in proposals and email templates related to proposals.

VariableWhat it renders
proposal.nameProposal title
proposal.numberProposal number (ID)
proposal.issueDateStart/ issue date
proposal.dueDateDue/ expiry date
proposal.signedDateDate the client signed
proposal.amountTotal amount due
proposal.linkClient-facing link to the proposal
proposal.custom.FIELD_IDAny proposal custom field

Invoice fields

Available in invoices, subscriptions, receipts, and related email templates.

VariableWhat it renders
invoice.nameInvoice title
invoice.numberInvoice number (ID)
invoice.refReference/ PO number
invoice.issueDateIssue date
invoice.dueDatePayment due date
invoice.paidDateDate paid
invoice.amountTotal amount due
invoice.agreementInvoice type (e.g. standard, split)
invoice.linkClient-facing link to the invoice
invoice.custom.FIELD_IDAny invoice custom field

Contract fields

VariableWhat it renders
contract.nameContract title
contract.numberContract number (ID)
contract.signedDateDate signed (shows each signer and date for multi-signee contracts)
contract.linkClient-facing link to the contract
contract.custom.FIELD_IDAny contract custom field

Project fields

Available in proposals, contracts, and any document linked to a project.

VariableWhat it renders
project.nameProject name
project.startDateProject start date
project.dueDateProject due date
project.custom.FIELD_IDAny project custom field

Subscription fields

Available in subscription documents and related emails.

VariableWhat it renders
invoiceSubscription.titleSubscription title
invoiceSubscription.amountRecurring amount
invoiceSubscription.typeBilling type (manual or auto)
invoiceSubscription.paymentOptionsPayment method
invoiceSubscription.startDateSubscription start date
invoiceSubscription.endDateSubscription end date
invoiceSubscription.upcomingInvoiceDateNext invoice date
invoiceSubscription.custom.FIELD_IDAny subscription custom field

Receipt fields

Available in receipt documents.

VariableWhat it renders
receipt.receiptNumberReceipt number
receipt.paymentMethodPayment method used
receipt.paidDateDate paid
receipt.amountAmount paid
receipt.linkClient-facing link to the receipt

Task fields

Available in automation actions and email templates triggered by task events.

VariableWhat it renders
task.titleTask title
task.descriptionTask description
task.statusCurrent status
task.dueDateDue date
task.startDateStart date
task.completedAtDate completed
task.assignedToAssigned to (name)
task.createdByAssigned by/ created by
task.followersFollower names (comma-separated)
task.projectProject name
task.taskBoardTask board name
task.taskGroupTask group (column) name
task.assigneeIdsAssignee IDs (for automations targeting recipients)
task.custom.FIELD_IDAny task custom field

Form fields

Available in form confirmation pages, related emails, and automations triggered by form submissions.

VariableWhat it renders
form.titleForm title
form.submitterName of the person who submitted
form.submitterPersonIdSubmitter's internal ID
form.responseFull form response (all answers)
form.custom.FIELD_IDAny form custom field

In automations, if the trigger is a form submission and a specific form is selected, individual form question responses also become available as variables. Each question appears as a separate field you can insert.

Sender and person fields

Sender fields represent the person sending the document or email. Person fields represent a contact record directly. Both share the same structure.

VariableWhat it renders
sender.firstName/ person.firstNameFirst name
sender.lastName/ person.lastNameLast name
sender.fullName/ person.fullNameFull name
sender.email/ person.emailPrimary email
sender.emailAltAlternative email
sender.phone/ person.phonePrimary phone
sender.phoneAltAlternative phone
sender.addressFull address
sender.role/ person.roleRole in workspace
sender.timezone/ person.timezoneTimezone
sender.company.nameSender's company name
sender.avatar.urlAvatar image URL (for email signatures)

Organizer fields

Available in scheduler booking confirmations and related emails. The organizer is the team member who owns the booking page.

VariableWhat it renders
organizer.firstNameFirst name
organizer.lastNameLast name
organizer.fullNameFull name
organizer.emailEmail
organizer.phonePhone

Other fields

VariableWhat it renders
other.dateNowToday's date at the time the document is rendered

The Invite category is used internally for invitation emails:

VariableWhat it renders
invite.linkThe invitation link for the recipient to join the workspace

Custom fields as variables

Every custom field you create on any record type automatically becomes available as a smart field variable. Custom field variables follow the pattern entity.custom.FIELD_ID, where FIELD_ID is the internal identifier of the custom field.

You don't need to know the field ID. When you click Variables in the toolbar, your custom fields appear by name at the bottom of each category. Click a custom field name and the correct variable is inserted automatically.

Custom fields from contacts and companies are available under the Client category. Custom fields from projects appear under Project. Custom fields from proposals, invoices, contracts, and other entities appear under their respective categories.

Conditional logic

Smart fields support #if and #unless blocks that show or hide content based on whether a field has a value.

The show or hide text with if/else guide walks through each condition with examples.

Show content only when a field has a value:

#if invoice.refReference: invoice.ref/if

If the invoice has no reference number, the entire line disappears from the rendered document, including the "Reference:" label. Plutio also cleans up stray <br> tags left behind by empty conditionals, so you won't end up with blank lines in the output.

Show content only when a field is empty:

#unless invoice.paidDatePayment pending/unless

The text "Payment pending" only appears if the invoice hasn't been paid yet.

If/else for two-way logic:

#if project.nameProject: project.nameelseNo project assigned/if

Shows the project name if one exists, otherwise shows "No project assigned".

Unless/else:

#unless invoice.paidDateAwaiting paymentelsePaid on invoice.paidDate/unless

You can use conditionals inside any content block. They're especially useful in templates where some fields might be filled for one client but empty for another. A common pattern is wrapping optional fields in #if blocks so the document adapts automatically:

Invoice number: invoice.number Issue date: invoice.issueDate Due date: invoice.dueDate #if invoice.paidDatePayment date: invoice.paidDate/if #if invoice.refReference: invoice.ref/if #if project.nameProject: project.name/if

Only the fields with values render. Empty ones are removed along with their labels and any trailing line breaks.

Looping with each

The #each block iterates over arrays. When a smart field resolves to a list of values (like task assignees), #each lets you render each item individually.

Most list-type fields like task.followers and task.assignedTo resolve to a pre-joined comma-separated string, so you can insert them directly without #each. For example, task.followers renders as "Sarah, James, Alex".

Address fields

Address variables have two modes. The client.address variable (without a sub-field) renders the full formatted address as a single block of text. The sub-fields (client.address.street, client.address.city, client.address.zipCode, client.address.country) render individual address parts.

You can use both in the same document. For example, the full address in one place and just the city in another. The same pattern applies to workspace.address, sender.address, and client.company.address.

Smart fields in automations

In automations, smart fields pull data from the trigger entity and any connected entities in the automation flow. If an automation is triggered by a form submission and creates an invoice, the automation's email action can reference both form variables (form1.title, form1.submitter) and invoice variables (invoice1.number, invoice1.amount).

Connection variables use a numbered suffix to distinguish between multiple connections of the same type: invoice1.number for the first invoice, invoice2.number if there are two. Each connection's available fields appear in the smart field picker when configuring the automation action.

Automation smart fields also include cross-entity references like invoice1.client.name to get the client assigned to a specific connected invoice.

What happens with empty variables

If a variable references a field that has no data, it stays in the document as the raw variable text (for example, client.phone appears literally). To avoid this, wrap optional fields in #if blocks so they disappear cleanly when empty.

The most common reasons a variable renders empty or as raw text:

  • No client assigned - the document doesn't have a contact linked to it yet, so all client fields are empty.
  • Missing data on the contact - the contact exists but the specific field (phone, address, company) hasn't been filled in.
  • Wrong entity context - using a proposal variable inside an invoice that isn't linked to a proposal.
  • Custom field deleted - the custom field was removed from settings, so the variable can't resolve.

To fix it, make sure the document has a client assigned, then check that the client's record in Contacts has the field filled in.

Tips and best practices

  • Use conditionals in templates - wrap every optional field in #if blocks when building templates. The document adapts to each client's data without leaving blank lines or raw variable text.
  • Full address vs parts - use client.address for a single-line formatted address. Use the individual parts (.street,.city,.zipCode,.country) when you need to control the layout, like placing city and postal code on separate lines.
  • Test with a real contact - before sending, preview the document with the actual client assigned. The preview renders all smart fields with real data so you can spot blanks or formatting issues.
  • Today's date - use other.dateNow for documents that need the current date at render time. The date updates every time the document is opened.
  • Email signatures - use sender.avatar.url for the sender's profile image and sender.fullName for their name in email signatures. Each team member's emails pull from their own profile data automatically.

Join 17,000+ businesses

★★★★★

4.6 on Capterra

No credit card required

Need help?

Workspace owners and co-owners can open a conversation with our support team from inside Plutio.

Try Plutio Free

Continue learning

More on contacts and CRM

Contacts overview

The Contacts page has two tabs: People and Companies. The People tab lists individual contacts; clients, leads, team members, and anyone you work with.

Contact custom fields

Custom fields extend People and Company records beyond the built-in fields, so any data specific to your business can be captured, filtered, and used.

Custom fields configuration

Custom fields let you add any data type to contacts, projects, tasks, invoices, proposals, contracts, and other entities in your workspace.

Proposal and contract templates

Proposals and contracts can be saved as templates, preserving every block, layout decision, content section, and pricing structure.

Email template branding

Email templates control the content and appearance of automated emails sent from your workspace.

Automations overview

Automations run actions automatically when something happens in your workspace, reducing repetitive manual steps.

Product

PricingIntegrationsFeaturesTemplates
new
Changelog
new

Support

On-boarding
Help centre
Contact usStatus

Resources

Community
AffiliatesStories & SetupsMagazine

Company

AboutIn the pressBrand assets

Platforms

API docs
iPhone & iPad
Android
Mac & Windows

Products

ContractsDashboardsFilesFormsInboxInvoicingProjectsProposalsSchedulingTasksTimesheets

Compare

vs 17hatsvs Acuityvs Agiledvs AND.COvs Asanavs Basecampvs Bloom.iovs Bonsaivs Calendlyvs ClickUpvs Clockifyvs Copilotvs Dubsadovs Flowluvs FreshBooksvs Harvestvs HoneyBookvs HubSpotvs Indyvs Mondayvs Moxievs Notionvs PandaDocvs Paymovs Pipedrivevs QuickBooksvs Scorovs SuiteDashvs Teamworkvs Togglvs Trellovs Wavevs Wrikevs Xerovs Zoho

Alternatives

17hatsAcuityAgiledAND.COAsanaBasecampBloom.ioBonsaiCalendlyClockifyCopilotDocuSignDubsadoFlowluFreshBooksHarvestHoneyBookHubSpotIndyMondayMoxieNotionPandaDocPaymoPipedriveProposifyQuickBooksScoroSuiteDashTeamworkTogglTrelloWaveWrikeXeroZoho

Solutions

AccountantsAgenciesArchitectsBookkeepersCoachesConsultantsCopywritersDesignersDevelopersEvent PlannersFreelancersInterior DesignersLawyersMarketersMusic ProducersPhotographersPR ProfessionalsReal Estate AgentsSmall BusinessSocial Media ManagersSolopreneursTherapistsVideo ProducersVideographersVirtual AssistantsWedding PlannersWriters

Free Tools

Break-Even CalculatorContract GeneratorDiscount CalculatorDiscount Code GeneratorInvoice GeneratorLate Fee CalculatorNDA GeneratorProfit Margin CalculatorProject Budget CalculatorRate CalculatorSalary to Hourly CalculatorSavings CalculatorTax CalculatorUK Tax Calculator
Twitter
YouTube
Instagram
Linkedin
Facebook
Terms of ServiceFair Usage PolicyPrivacy PolicyCookie PolicyGDPR CommitmentData Processing AgreementSub-processorsNotice at collectionPrivacy choices
Plutio customer review signature
Plutio Logo

One app to run, grow, and automate your business with Super Work AI

Plutio customer review signature