Updated Dec 19, 2023
If this is the first time you've seen the term smart field, see our help article on personalizing emails with smart fields for an introduction to what they are and what they do!
This article lists every single smart field in Dubsado, organized by the headings in the Smart Field menu.
⛔ Heads up! Always insert smart fields using the smart field menu! Do not copy and paste the smart fields from this article because it may cause an error.
Project smart fields
Project smart fields can autofill basic information about the project in any form or email that you send through a project.
Project title and date
These smart fields autofill the project title and date, located at the top of the project sidebar.
Date and time formatting will follow your local conventions based on the timezone set under Settings > International Settings. The examples listed in the table below are based on being in the United States.
Name | Smart field | Description |
Project Title |
| Title of the project |
Project Start |
| Starting date of the project (MMM D, YYYY)
Example: Feb 9, 2023 |
Project Start Time |
| Starting time of the project (H:MM) |
Project End |
| Ending date of the project (MMM D, YYYY) |
Project End Time |
| Ending time of the project (H:MM) |
Project location
These smart fields autofill information from the project address, which is set further down in the project sidebar, below the Portal section.
Name | Smart field | Description |
Address |
| Project location address with line breaks: Location name Location address line 1 Location address line 2 City State / Province Zip / Postal Country
Example: Dub Design Co 123 Main St Suite 102 Burbank, CA 91502 USA |
Location Name |
| Project location name |
Location Contact Name |
| Project location contact |
Client smart fields
Client smart fields autofill basic information about the client and are useful when creating a contract or email templates. All of the information is pulled from the client profile found in Utilities > Address Book. You can see a preview in the project sidebar.
Name | Smart field | Description |
Full Name |
| First and last name of the primary client |
First Name |
| First name of the primary client |
Last Name |
| Last name of the primary client |
| Email address of the primary client | |
Phone |
| Phone number of the primary client |
Alt Contact First |
| First name of alternate contact |
Alt Contact Last |
| Last name of the alternate contact |
Alt Email |
| Email of the alternate contact |
Alt Phone |
| Phone number of the alternate contact |
Company Name |
| Company name |
Address |
| Address in the client profile, with line breaks: Line 1 Line 2 City, State / Province Zip / Postal Country
Example: 456 Main St Apt 204 Burbank, California 91501 |
Address - Compact |
| Address in the client profile, all on one line
Example: 456 Main St Burbank, California 91501 |
Shipping Address |
| Shipping address in the client profile, with line breaks: Line 1 Line 2 City, State / Province Zip / Postal Country
Example: 456 Main St Apt 204 Burbank, California 91501 |
Invoice smart fields
Invoice smart fields autofill information from the primary invoice on a project. If there are multiple invoices on a project, these smart fields will only pull information from the invoice marked as primary.
One way to use invoice smart fields is to add them to a contract template, and then attach the contract to a proposal. That way, after the client submits the proposal, an invoice gets automatically created, and the smart fields autofill the invoice details on the contract!
Name | Smart field | Description |
Invoice Total |
| Total invoice amount, including tax and discounts |
Invoice Subtotal |
| Invoice subtotal, before taxes and discounts |
Invoice Tax Total |
| Total amount of tax charged on the invoice |
Invoice Remainder |
| Remaining balance left to pay on the invoice |
Invoice Amount Paid |
| Total amount the client has paid on the invoice so far |
Invoice Discount |
| Total dollar amount discounted from the invoice |
Invoice Item Names & Amounts |
| Table that displays the invoice item name, description, quantity, unit price, tax, and subtotal for each line item |
Invoice Item Names & Descriptions |
| Displays the line item name followed by a bulleted list description of the line item Example:
|
Invoice Item Names |
| Name of each item name with line breaks |
Invoice Number |
| The invoice number listed in Dubsado |
Invoice Payment Plan |
| Table that displays the Due date and Amount due for each installment of the invoice payment plan
|
Invoice Title |
| Title of the invoice if you manually changed it |
Business smart fields
Business smart fields autofill information about you, the business owner. They are pulling from your brand and login settings.
Business smart fields will not autofill information about multi-users added to your brand. They will only pull in information about the brand owner.
Name | Smart field | Description |
Full Name (may appear as User Full Name) |
| Your first and last name (Settings > Login settings) |
First Name (may appear as User First Name) |
| Your first name (Settings > Login settings) |
Last Name (may appear as User Last Name) |
| Your last name (Settings > Login settings) |
Business Email |
| Your business email (Settings > Branding) |
Phone (may appear as Brand Phone) |
| Your phone number (Settings > Branding) |
Logo (may appear as Brand Logo) |
| Your uploaded logo image (Settings > Branding) |
Business Name (may appear as Brand Name) |
| The name of your brand (Settings > Branding) |
Business Address (may appear as Brand Address) |
| The address of your business with line breaks (Settings > Branding): Line 1 Line 2 City, State/Prov Zip/Postal
Example: 123 Main St Suite 102 Burbank, CA 91502 |
Email Signature (may appear as Brand Email Signature) |
| Displays your email signature (Templates > Canned Emails > Signature) |
Date smart fields
Date smart fields will autofill the current date and time. For example, if you have a date smart field in your contract template, and you add that contract to a project on June 3, the date will fill in as June 3 and remain that way.
Date and time formatting will follow your local conventions based on the timezone set under Settings > International Settings.
Name | Smart field | Example |
Date & Time |
| US: Feb 9, 2021 1:30:00 PM
International: Feb 9 13:30:00 |
Long Date |
| US: February 9, 2021
International: 9 February 2021 |
Medium Date |
| US: Feb 9, 2021
International: 9 Feb 2019 |
Short Date |
| US: 2/9/21
International: 02/09/21 |
Time |
| 12 hour: 1:30 PM
24 hour: 13:30 |
Smart field links
Smart field links are used to generate links to Dubsado documents, like forms, schedulers, and invoices. They will display the link as a large button in your brand color. They are most commonly used when writing canned email templates and generally should not be added to a form template.
👋 Here’s a tip… Check out our help article for more information on using smart field links in a Dubsado form.
Name | Smart field | Description |
Invoice Link |
| Button that links to the primary invoice Example: |
Contract Link |
| Button that links to the project’s contract. Default text displays the contract title |
Portal Link |
| Button that links to the client portal
Example: |
Portal Password |
| Displays the password to the client portal as text
Example: joedubsado123 |
Form Link |
| Button that links to a sub-agreement, questionnaire, or proposal. Default text displays the form title
Example: |
Scheduler Link |
| Button that links to a scheduler
Example: |
Scheduler Group Link | {{schedulerGroup | schedulerGroupLink}} | Button that links to a scheduler group
Example: |
Package smart fields
Package smart fields can only be used within a package element text box while creating a proposal. They pull from the selected package template.
These smart fields display information about the package, similar to invoice smart fields
Name | Smart field | Description |
Package Name |
| Name of the package as it appears listed under Templates > Packages |
Package Total With Tax |
| Total cost of the package, including tax
Example: $500.00 |
Package Total No Tax |
| Total cost of the package before tax
Example: $500.00 |
Package Tax Total |
| Sum of all tax charged in the package
Example: $8.59 |
Package Item Names & Amounts |
| Displays a table with the item name, description, quantity, unit price, tax, and subtotal for each line item in the package
Example: |
Package Item Names & Descriptions |
| Displays the line item name followed by a bulleted list description for each line item in the package
Example: Basic Package -
|
Package Item Names |
| Name of each item in the package, with line breaks: Line item 1 Line item 2
Example: Basic Package Warranty |
Package selection buttons
These smart fields display something that your client can click on to select a package. Which one you use for each package is mostly up to your personal taste — you can even add your own text above or beside quantity and checkboxes!
Name | Appearance | Description |
Quantity |
| Editable quantity box for the client to type in their desired quantity for the package |
Large Checkbox |
| Large checkbox for the client to select the package |
Small Checkbox |
| Small checkbox for the client to select the package |
Button | The default button on new packages. Default text is "Select" |
Appointment smart fields
Appointment smart fields can only be used in the following email templates:
The default appointment email templates from Templates > Canned Emails > Edit Templates. Specifically, appointment confirmed, appointment rescheduled, or appointment cancelled.
A custom email template that you use in a scheduler template (Templates > Scheduler) for the confirmation email or reminder emails.
These smart fields will not work in any other circumstance because they would not know which appointment to pull from.
Name | Smart field | Description |
Appointment Name |
| First and last name of the client who booked followed by a dash and the name of the appointment, pulled from the name of the scheduler template
Example: Becca Berg — Consultation Call |
Appointment Location |
| Location of the appointment pulled from what you set in the Location field on the scheduler template |
Appointment Duration |
| How long the appointment lasts, pulled from Appointment duration |
Appointment Start Date |
| Start date of the appointment (MMM D, YYYY) |
Appointment End Date |
| End date of the appointment (MMM D, YYYY) |
Appointment Start Time |
| Start time of the appointment (H:MM) along with the client's timezone
Example: 3:30 PM (PST) |
Appointment End Time |
| End time of the appointment (H:MM) along with the client's timezone
Example: 3:30 PM (PST) |
Appointment Cancellation Reason |
| Cancellation reason provided by the client when they cancel an appointment. This only works in the Appointment Cancelled default canned email template |
Appointment Reschedule Button |
| Button in your brand color that allows the client to reschedule their own appointment
Example: |
Appointment Cancel Button |
| Button that allows the client to cancel their own appointment. Color can't be changed
Example: |
Appointment Conferencing Link |
| Clickable link to a video conferencing link generated by the scheduler
You'll need video conferencing connected to Dubsado and turned on in the scheduler template
Example: |
Add to Calendar Link |
| Clickable link for the client to add a scheduled appointment to their calendar
Example: |
Form smart fields
Form smart fields reference the specific sub-agreement, questionnaire, or proposal being sent. They will work in a canned email template when sending a form through a project manually or with a workflow.
Name | Smart field | Description |
Title |
| Displays the form title as text as seen within the form in Templates > Forms
Example: Design Co Questions |
Link |
| Button that links to a sub-agreement, questionnaire, or proposal. Default text displays the form title
Example: |
Type |
| Displays the type of form you are sending as text, either "sub agreement", "questionnaire", or "proposal" |
Expiration Date |
| Expiration date of the form, if specified in Form settings
This only works in the Form Reminder email template found in Templates > Canned Emails > Edit Templates |
Payment plan smart fields
Payment plan smart fields will only work in a canned email set as a payment reminder in a payment plan. If a canned email with a payment plan smart field is sent manually or through a workflow, the smart field will not work.
Name | Smart field | Description |
Due Date |
| Due date of payment (M/D/YY). Will include a relative trigger if there is one
Example with a relative trigger: 2/18/21 - 30 day(s) before project start date |
Due Date - Simple |
| Due date of payment only (M/D/YY) |
Amount Due |
| Amount due and relative percentage of remaining invoice
Example: $900.00 - 50% of remaining invoice |
Amount - Simple |
| Amount due only, without the percentage of remaining invoice
Example: $900.00 |