Template variable reference

Special Template Names

Cashboard recognizes a set of default templates that are necessary to drive the application.

client Handles display of your client's address
company Handles display of your company address
css_document Holds CSS information and included by default in estimate and invoice
email_ Various emails that Cashboard sends to your clients
html_estimate Estimate document
html_invoice Invoice document
html_payment Payment receipt
html_statement_invoice Multi-invoice statement
invoice_row Handles display of your single invoice rows

Variables

These are the different variables you can access from your Liquid templates inside Cashboard.

Some of these variables are collections, which can be looped using this syntax:

{% for thing in collection %}
 ...do something with thing...
{% endfor %}`

Collections are noted here by nested list items. Assuming you'd like to access a nested item (like the company name for your account), you'd do this: {{ account.company.name }}

Account

Contact

Accessible from any email template

  • email_address
  • address
  • address2
  • city
  • country_name
  • custom_1
  • custom_2
  • custom_3
  • first_name
  • last_name
  • name
  • state
  • telephone
  • url
  • zip

Client

Accessible as a collection from Estimate, Invoice, Payment

  • address
  • address2
  • balance
    (This client's overall monetary balance with you. Can be a negative number.)
  • city
  • country_name
  • custom_1
  • custom_2
  • custom_3
  • name
  • outstanding_credit
    (The unapplied payment amount your client has with you. Never will be a negative number.)
  • state
  • telephone
  • url
  • zip

Company

Accessible as a collection from Account

  • address
  • address2
  • city
  • country_name
  • custom_1
  • custom_2
  • custom_3
  • name
  • state
  • telephone
  • url
  • zip

Estimate

Accessible from html_estimate, email_estimate_notice, html_payment

  • address
    (Estimate address field if filled in, or address from client)
  • agreed_to
  • agreement_text
  • client_url
  • client
  • created_on
  • discount_low
  • discount_high
  • discount_percentage
  • deposit_amount
  • deposit_paid
    (true / false)
  • deposit_required
    (true / false)
  • has_worst_case_items
    (Did you use high numbers to estimate this as well as low?)
  • intro_text
  • item_actual_low
  • item_actual_high
  • line_item_count
  • line_items
    • description
    • estimate_time
      Biggest number, either high or low - hours
    • flat_fee
    • has_flat_fee
    • has_price_per
    • has_worst_case
    • is_taxable
    • price_best
    • price_worst
    • price_per
    • title
    • time_best (for task items only)
    • time_worst (for task items only)
    • unit_label
      Hours, units, things, etc
    • quantity_low
    • quantity_high
    • quantity_estimate
      The biggest number, either high or low
    • type_str
      Task, Product, Generic
  • name
  • number
  • po_number
  • price_best
  • price_worst
  • project
    • id
    • name
    • po_number
  • requires_agreement
  • sales_tax
  • sales_tax_2
  • should_apply_discount
  • status
    (Ready to go | Needs agreement)
  • tax_cost_total_low
  • tax_cost_total_high
  • tax_cost_low
    (Low dollar amount of tax applied with 'salestax')_
  • tax_cost_high
    (High dollar amount of tax applied with 'salestax')_
  • tax_cost_2_low
    (Low dollar amount of tax applied with 'salestax_2')_
  • tax_cost_2_high
    (High dollar amount of tax applied with 'salestax_2')_
  • time_best
    (Best case estimated hours)
  • time_worst

Invoice

Accessible from html_invoice, html_statement_invoice, email_invoice_notice, email_invoice_statement...

  • address
    (Invoice address field if filled in, or address from client)
  • balance
    (Amount remaining to be paid on invoice)
  • client_url
  • client
  • created_on
  • due_date
  • discount
    (Dollar amount of discount applied)
  • discount_percentage
  • early_period_in_days
  • early_discount
    (Amount of discount available)
  • has_been_paid
    (Has this invoice been paid in full?)
  • include_time_entries
    (Should we show time entries on this invoice? Controlled by details checkbox.)
  • invoice_date
  • items_ad_hoc
    (Items on an invoice that don't belong to any project)
  • items_by_project
    (Items on invoice, grouped by project they belong to)
  • item_actual
    (Amount total of all items)
  • late_fee
    (Amount of late fee charged)
  • late_percentage
  • late_period_in_days
  • line_item_count
  • line_items
    (All individual items on the invoice)
    • description
    • flat_fee
    • price_per
    • project
      (Contains associated project name if it exists)
    • quantity
    • time_entry_count
    • time_entries
    • created_on
    • minutes
    • person_name
    • description
    • title
    • total
  • notes
  • number
  • paid_on
  • payment_count
  • payments
    (Payments made on invoice)
    • amount
    • created_on
    • number
  • po_number
  • project_count
  • projects
    (Projects this invoice is for)
    • id
    • name
    • po_number
  • sales_tax
  • sales_tax_2
  • should_apply_flat_discount
    (true/false)
  • should_apply_early_discount
    (true / false)
  • should_apply_late_fee
    (true / false)
  • tax_cost
    (Dollar amount of tax cost)
  • tax_cost_2
    (Dollar amount of tax cost 2)
  • total
    (Total of the invoice)
  • total_quantity
    (The total quantity for the entire invoice)
  • total_quantity_time
    (Total quantity of _time entries for an invoice)_

Payment

Accessible from html_payment

  • amount
  • client_url
  • client":#client
  • created_on
  • "estimate
  • invoices
    • amount
    • created_on
    • number
  • invoice_count
  • notes
  • number

Recent Discussions

28 Sep, 2024 06:47 AM
16 Sep, 2024 09:53 PM
10 Sep, 2024 12:44 AM
10 Sep, 2024 12:44 AM
10 Sep, 2024 12:40 AM