Skip to main content
Version: v6

Invoice Iconic Premium Template: How to Install and Configure

A stack of Invoice Iconic documents printed on A4 paper, leaning against a wall at a 10-degree angle.

Invoice Iconic is a vibrant invoice template that can be purchased from the Gravity PDF Template Shop. This guide walks you through the process of installing and configuring Iconic to its full potential.

Installation

Please follow our installation guide, which provides initial instructions for setting up and configuring your premium template.

note

This documentation is for Iconic version 2.x, which adds multi-rate tax-inclusive pricing, grouped or itemized discounts, free trial, localized dates, and Gravity Wiz eCommerce Fields support. Looking for the 1.x documentation? You can find the Iconic v1 docs here.

Limitations

Invoice templates can only be used with forms that include a Gravity Forms Product field. If you try to use the invoice on a form without any products (or conditional products where no product is included for a specific entry) an error message will be shown in the PDF. If you do have conditional Products, enable PDF Conditional Logic to match.

If you have the Gravity Wiz eCommerce Fields perk and the form includes the Tax field, tax-inclusive pricing in the PDF invoice is automatically disabled. You cannot use tax-inclusive and tax-exclusive pricing together.

The 2.x invoice templates require Gravity PDF version 6.0 or higher to correctly function.

Configuring

All PDF templates have common settings – such as font, security, and notification attachments – and we recommend you review the PDF setup guide to familiarize yourself. Common settings are found in the General, Appearance, and Advanced panels. All invoice-specific settings can be found in the Template panel.

Below you'll find detailed information about each Template setting available to Iconic. The invoice PDF configuration is split up into six sections:

Iconic also has these additional template-specific settings:

Highlight Color

  • The background color for the Invoice Summary section.
  • The default value is #eeeeee

Show Currency Code

  • Toggle the Currency Code (e.g. USD, EUR, AUD) on / off in the Invoice Summary section.
  • The default value is "off"

Business Details Label

  • The label displayed above the Business Name in the invoice.
  • The default value is "Business Details".

Business Address Label

  • The label displayed above the Business Address in the invoice.
  • The default value is "Business Address".

Company Information

A close-up screenshot of the header section of Iconic, with numbers one through seven positioned on the invoice area, and controlled by the numbered settings documented in the Company Information section.

Logo (1)

  • This image is included at the top of the generated PDF invoice.
  • To ensure your PDF generates quickly, and the PDF file size stays small, we recommend using an image under 250kb (run it through an image optimizer to get it as small as possible).
  • The image will be positioned on the left-hand or right-hand side of the invoice, and is determined by the Logo Position setting.

Logo Position

  • Control the position of the Logo image in the PDF. The Logo can be positioned Left or Right at the top of the invoice.
  • If the Logo is positioned Right, the Invoice Title will automatically swap to the left-hand side.
  • By default, logos are positioned on the Left in the invoice.

Business Name (2)

  • Enter your business or trading name that should get displayed in the invoice.
  • You may use Gravity Forms merge tags to populate this setting.

Business Address (3)

  • The business address is divided into three separate fields, each occupying a line in the invoice.
  • You may use Gravity Forms merge tags to populate these three settings.
  • If you use any of these symbols , | / \ - – to separate multiple merge tags (e.g. {City:3.3}, {State:3.4}, {Zip:3.5}), and a merge tag is replaced with an empty value, the extra symbol(s) will be automatically removed.

Registration Number (4)

  • If applicable, include a business registration number here (e.g. EIN in the US, ABN in Australia, and CRN in the UK).
  • You may use Gravity Forms merge tags to populate this setting.

Contact Information (5)

  • You can include your phone number, email address, fax, or website.
  • You may use Gravity Forms merge tags to populate this setting.

Additional Contact Information (6)

Additional Information (7)

  • There are two fields where you can include additional information about your company.
  • You may use Gravity Forms merge tags to populate these setting.

Invoice Settings

A close-up screenshot of the header section of Iconic, with numbers one through five positioned on the invoice area, and controlled by the numbered settings documented in the Invoice Settings section.

Invoice Number Prefix (1)

  • This is an optional field that appears before the Invoice Number in the PDF.

Invoice Number (2)

  • The invoice number to be used in the PDF. By default, this is set to the unique Entry ID using the merge tag {entry_id}.
  • The Entry ID is not sequential for a specific form, and will increment for every entry you have across all your forms. If you require your form / invoices to have sequential number, we recommend using the Gravity Wiz Unique ID perk.

Invoice Number Suffix (3)

  • This is an optional field that is included after the Invoice Number in the PDF.

Invoice Date (4)

Date Format (4)

  • Select the date format used for the Invoice Date and Invoice Due Date (if set).
  • The following date formats are supported:
    • 11/29/2024 (mm/dd/yyyy)
    • 11/29/24 (mm/dd/yy)
    • 29/11/2024 (dd/mm/yyyy)
    • 29/11/24 (dd/mm/yy)
    • 29-11-2024 (dd-mm-yyyy)
    • 29-11-24 (dd-mm-yy)
    • 29.11.2024 (dd.mm.yyyy)
    • 29.11.24 (dd.mm.yy)
    • 2024/11/29 (yyyy/mm/dd)
    • 24/11/29 (yy/mm/dd)
    • 2024-11-29 (yyyy-mm-dd)
    • 24-11-29 (yy-mm-dd)
    • 2024.11.29 (yyyy.mm.dd)
    • 24.11.29 (yy.mm.dd)
    • November 29, 2024 (mmmm d, yyyy)
    • Nov 29, 2024 (mmm d, yyyy)
    • 9 November 2024 (d mmmm yyyy)
    • 9 Nov 2024 (d mmm yyyy)
    • 2024 November 29 (yyyy mmmm d)
    • 2024 Nov 29 (yyyy mmm d)
    • WordPress Date Format (date configured in Settings -> General)
  • When necessary, the WordPress Language your site is configured with will be used to translate the date.
  • If your preferred date format isn't available, the gfpdf_invoice_date_format filter can be used to adjust it.

Invoice Due Date (5)

  • You can show a due date in the invoice, which is configured by entering the number of days an invoice is due after the form submission date. For example, if the form submission date is 2024-11-29, and this setting is set to 7 days, the invoice would be shown as due on 2024-12-06.
  • The default value for this setting is 0, which disables this feature.

Buyer Information

A close-up screenshot of the mid section of Iconic, with numbers one through five positioned on the invoice area, and controlled by the numbered settings documented in the Buyer Information section.

Buyer Name (1)

  • Provide the name of the individual or company making the purchase.
  • You may use Gravity Forms merge tags to populate this setting.

Buyer Address (2)

  • The buyer address is divided into three separate fields, with each field corresponding to a line on the invoice.
  • You may use Gravity Forms merge tags to populate these three settings.
  • If you use any of these symbols , | / \ - – to separate multiple merge tags (e.g. {City:3.3}, {State:3.4}, {Zip:3.5}), and a merge tag is replaced with an empty value, the extra symbol(s) will be automatically removed.

Buyer Registration Number (3)

  • If applicable, include your buyer's registration number here (EIN in the US, ABN in Australia, and CRN in the UK).
  • You may use Gravity Forms merge tags to populate this setting.

Buyer Contact Information (4)

  • You can include the buyer's phone number, email address, fax, or website.
  • You may use Gravity Forms merge tags to populate this setting.

Buyer Alternate Contact Information (5)

Tax Settings

Gravity Forms doesn't natively support taxes for Pricing fields. You could use a Product Calculation field to calculate each product's tax, but there are limitations. For example, it can be challenging to update the calculations when you add/remove products in your form, the tax amount will be displayed in the line items (and not the totals section), and this method only supports tax-exclusive pricing. Thankfully, you have more feature-rich tax options available.

All Gravity PDF Invoices natively support tax-inclusive pricing, and you are able to set individual tax rates for each product (or disable taxes for a product entirely). If you require tax-exclusive pricing, the Gravity Perks eCommerce Fields perk includes a Tax field, and is fully supported by Gravity PDF Invoices.

A screenshot of Iconic, with numbers one through seven positioned on the invoice area, and controlled by the numbered settings documented in the Tax Settings section.

Enable Tax Inclusive Pricing

  • Automatically calculate the taxes that apply to your products using the Default Tax Rate, and any modifiers.
  • By default, tax-inclusive pricing is disabled on invoices.
  • Multiple tax rates are supported for products using the Custom CSS Class tax-{rate}-{label} on Product or Shipping fields in the Form Editor. The {rate} is a percentage between 0 and 100. While the {label} is the name of the tax (substitute spaces for hyphens). For example, if you wanted a specific product to be taxed at 5.25% with the label "CA Taxes", you would add the CSS class tax-5.25-CA-Taxes to the Product field in the Form Editor.
  • You cannot add different tax rates directly to Option fields; it can only be added to Products. Option fields will inherit the tax rate of the associated Product field.
  • Taxes can be disabled on a per-product basis using the Custom CSS Class tax-0. Do not include the label -{label} when disabling taxes this way.
  • If you have the Gravity Wiz eCommerce Fields perk activated on your website, tax-inclusive pricing is automatically disabled when a Tax field is included in the form.

A screenshot of the Gravity Forms Editor with a Product field selected, the Custom CSS Class setting is highlighted in the Field Settings section, the value of the setting shows tax-7.25-California, which is how you define multiple tax rates in the invoice.

Default Tax Name (1)

  • Provide the name of the default tax being applied to products and shipping fields (if taxes on shipping is enabled). For example, Sales Tax in the US, VAT in Europe, GST in Australia.
  • This label is displayed with the tax calculated using the Default Tax Rate in the invoice.

Default Tax Rate (2)

  • Provide a percentage between 0 and 100 to be used as the default tax rate. For example, you would enter 10 for GST in Australia.
  • The default tax rate can be overridden on a per-product basis using the Custom CSS Class tax-{rate}-{label} or tax-0.

Tax Summary Label (3)

  • The label shown with the total invoice tax, which is displayed in the Invoice Summary.
  • You can hide this information using the Hide Tax Summary setting.
  • The default value is "Tax Total:".

Unit Tax Column Label (4)

  • The heading used for the Unit Tax column of the Product Table.
  • The Unit Tax column is displayed automatically if Tax Inclusive Pricing is enabled. You can hide the column using the Tax Column setting.
  • The default value is "Unit Tax".

Tax Shipping (5)

  • When enabled alongside tax-inclusive pricing, taxes will be calculated for the Shipping field using the Default Tax Rate, or the tax-{rate}-{label} modifier.
  • By default, taxes on the Shipping field is disabled.

Hide Tax in Summary

  • By default, the total tax is shown in the Invoice Summary section (the top of the PDF). Tick this box to remove the tax amount from the summary.

Hide Tax Column

  • When enabled, the Unit Tax column will be hidden from the Product Table.

Tax Number (6)

  • Provide your company's tax number (if applicable). For example, VAT-registered companies have a Tax Identification number which can be included.
  • You may use Gravity Forms merge tags to populate this setting.

Tax Number Label (7)

  • The label to be displayed next to the Tax Number.
  • This label will not be included in the invoice if Tax Number is left blank.
  • The default value is "Tax Number:".

Extras

A screenshot focused on the bottom half of Iconic, with numbers one through four positioned on the invoice area, and controlled by the numbered settings documented in the Extras section.

Discounts (1)

  • By default, any discounts included via Gravity Forms Coupon field, or Gravity Wiz's Discount field, will be totaled and shown alongside the Discount Label (see image above for an example).
  • If you enable the Itemized Discounts / Coupons setting, any discounts that apply will be shown individually, and not grouped together (see image below for an example).

A screenshot focused on the bottom half of Iconic, and showing individual discount amounts, which can be configured with the Itemized Discounts / Coupons setting.

Watermark (2)

  • You can include a text watermark in the invoice, which will display diagonally across the PDF from the bottom-left to the top-right corner.
  • By default, the setting is left blank.

Additional Information (3)

  • A Rich Text Editor allows you to include information below the Product Table. This setting is ideal for adding payment terms, a "Thank You" note, or delivery instructions.
  • You may use Gravity Forms merge tags to populate this setting.
  • Include text to display at the bottom of each page in the invoice.
  • This text will be center-aligned.
  • You may use Gravity Forms merge tags to populate this setting.

Labels

A screenshot of Iconic, with numbers one through thirteen positioned on the invoice area, and controlled by the numbered settings documented in the Labels section.

All text in the PDF can be easily changed. By default, the labels are displayed in English, but you can easily translate them. Many elements in the PDF can be disabled by saving a blank label.

Invoice Title Label (1)

  • The document title, which is displayed in the top-left or top-right of the invoice (depending on the Logo Position setting).
  • The default value is "Invoice". Australian businesses registered for GST should change their invoice title to "Tax Invoice".

Invoice Date Label (2)

  • The label displayed next to the Invoice Date value. Leave blank to disable.
  • The default value is "Invoice Date:".

Invoice Due Date Label (3)

  • The label displayed next to the Invoice Due Date value.
  • The default value is "Due Date:".

Invoice Number Label (4)

  • The label displayed next to the Invoice Number value. Leave blank to disable.
  • The default value is "Invoice Number:".

Invoice Total Cost Summary Label (5)

  • The label displayed next to the invoice total value in the Summary Section. Leave blank to disable.
  • The default value is "Invoice Total:".

Buyer Details Label (6)

  • The label displayed above the Buyer Name / Contact Info values.
  • The default value is "Buyer Details:".

Quantity Column Label (7)

  • The label displayed in the Product Table header for the Quantity column. The column cannot be removed.
  • The default value is "Qty".

Description Column Label (8)

  • The label displayed in the Product Table header for the Description column. The column cannot be removed.
  • The default value is "Description".

Unit Price Column Label (9)

  • The label displayed in the Product Table header for the Unit Price column. The column cannot be removed.
  • The default value is "Unit Price".

Total Column Label (10)

  • The label displayed in the Product Table header for the Total column. The column cannot be removed.
  • The default value is "Total".

Subtotal Label (11)

  • The label displayed next to the invoice subtotal value (the total cost for all products, excluding shipping and taxes), after the line items. Leave blank to disable.
  • The default value is "Subtotal".

Discount Label (12)

  • The label displayed next to the total discounts applied to the order (using the Coupons or Discount field).
  • If there are no discounts, or the Itemize Discounts / Coupons setting is enabled, this label will not be included in the invoice.
  • The default value is "Discount".

Overall Total Label (13)

  • The label displayed next to the invoice total value (the overall cost), after the line items. The label/value cannot be removed.
  • The default value is "Total".

Iconic comes bundled with Roboto Condensed which is an open source licensed font (Apache License, Version 2.0). For the best results, we recommend using Roboto Condensed at 10pt. Set the PDF font in the Appearance section.

Viewing PDF

Once you've saved your new PDF, you can view it from the Gravity Forms Entries List page. You can allow a user to download the invoice by adding the [gravitypdf] shortcode to the form Confirmation.

Notification Email PDF Attachment

You can easily add the invoice as an attachment in your Notification emails. First, ensure you've created the appropriate Notification(s) for your form. Once done, you can configure the Notification PDF setting for your invoice.

Enhance Invoices With Gravity Perks

Gravity Perks is a suite of add-ons or "perks" that can enhance Gravity Forms functionality. From the 47+ perks the Wizards have to offer, a number of those can enhance Gravity PDF Invoices. Here's a non-exhaustive list to consider:

Gravity Forms eCommerce Fields

This perk adds new eCommerce features to Gravity Forms, including Tax, Discounts, and Subtotal fields. We recommend using this perk If you require tax-exclusive pricing in your invoices (the enhanced Discount field is handy, too).

A screenshot of the Gravity Forms Editor with a Gravity Forms eCommerce Fields Tax field selected, an arrow points to the Tax Amount setting in the Field Settings section, the value of the setting shows 7.25%.

The Tax field allows you to apply taxes on all products/shipping fields, or you can selectively include/exclude fields from taxes. For multiple rates, you can add additional Tax fields to your form, as well as conditionally show/hide the field. The perk auto-calculates the correct taxes for an entry based on the rules, conditions, and product quantities selected.

info

You cannot use tax-inclusive and tax-exclusive pricing together. The Tax Inclusive Pricing feature is automatically disabled once you add a Tax field to your form.

When a Tax field is detected in the form, all tax-inclusive invoice settings are removed. You still have control over the Tax Summary and Tax Number settings.

Gravity Forms Unique ID

The Unique ID Gravity Wiz perk allows you to generate a sequential or alphanumeric ID for each entry on a per-form basis. To use with PDF Invoices, replace the entry ID merge tag in the Invoice Number setting with the Unique ID equivalent.

A screenshot of the Gravity Forms Editor with a Unique ID field selected, an arrow points to the Field Settings section, which has been configured as a sequential number with a prefix of 'PDF' and a suffix of 'Y23'.

Gravity Forms Inventory

If you'd like to use Gravity Forms to sell tickets / take bookings in limited quantities, the Inventory perk is useful. One (of the many) features available is inventory tracking for Product fields. PDF Invoices supports this perk automatically when used with Products, without any extra configuration on your part.

tip

Pro Tip: Use the QRCode and Easy Passthrough perks to create an event check-in tool, and then add the check-in QRCode to your invoice via the Additional Information setting.

Gravity Forms Conditional Pricing

You can create complex pricing rules for Product fields with the Conditional Pricing perk. This saves adding a heap of different conditional products to your form, and is very useful if your pricing regularly changes. PDF Invoices supports this perk automatically, without any extra configuration on your part.

Gravity Forms Advanced Calculations

The Advanced Calculations perk does exactly as the name suggests: advanced number crunching using Gravity Forms data. It supports the Calculation Product field, so you can create complex product pricing. PDF Invoices supports this perk automatically when used with Product fields, without any extra configuration on your part.

Gravity Forms Price Range

Gravity Forms natively supports user-defined pricing for Product fields. But what if you require a minimum (or maximum) spend? The Pricing Range perk enables this functionality. PDF Invoices supports this perk automatically, without any extra configuration on your part.

Upgrading from v1.x

For existing customers who'd like to take advantage of the new features included in v2, you'll first need to manually upgrade your Invoice PDF template(s). If you don't require any of the new features, you may continue with the v1 template; we will provide support for both v1 and v2 for the foreseeable future.

Before you complete the upgrade, take note of the changes that have been made to all v2 invoices:

  1. Gravity PDF v6 or higher is required.
  2. The Basic Tax feature has been renamed Tax Inclusive Pricing.
  3. To support the new multi-tax rate feature, the Tax Name and Tax Rate settings have been renamed Default Tax Name and Default Tax Rate, respectively.
  4. You can override the Default Tax Rate on a per-product field basis using the Custom CSS Class tax-{rate}-{label} or tax-0.
  5. To support the new multi-tax rate feature, the Tax Rate Label setting has been removed and will no longer appear in the Invoice Summary. Instead, the rate will be shown alongside the tax label in the Invoice Table.
  6. A new Tax Summary Label setting has been added, and will be used in this section of the invoice alongside the total tax value.
  7. A new Unit Tax Column Label setting has been added, which is used in the tax column of the Invoice Table. The Unit Tax Column Label defaults to the text "Unit Tax".
  8. A new setting Itemize Discounts / Coupons has been added. By default, the invoice will group any discounts into a single total. When the setting is enabled, all discounts will be shown in the invoice individually.
  9. A new Discount Label setting has been added. It is used if your form includes a Coupon or Discount field, and you haven't enabled the Itemize Discounts / Coupons setting. It defaults to the text "Discount".
  10. Support for tax-exclusive pricing via Gravity Wiz's eCommerce Field perk has been added. When a Tax field is added to the form, the Tax Inclusive Pricing feature is disabled.
  11. Support for Free Trial Gravity Forms subscriptions has been added to the invoice.
  12. The Date Format setting includes 20 new choices, and the date will be automatically localized using your WordPress Site Language setting. The default date will automatically match your WordPress Date Format setting.

Before upgrading, we strongly recommend taking a full backup of your website. After you complete the upgrade, you should review the PDF Invoices being generated by each of your forms, and ensure the output is acceptable. For customers who have translated the invoices, you may need to edit the invoice PDF settings and translate the new labels that have been added.

If there is an issue with your v2 invoices after upgrading, restore the site from the backup you took. You can also attempt to downgrade back to the v1 invoice template, which can be downloaded from your GravityPDF.com account.

Developers

Developers can customize the invoice by editing the template file, or using of the hooks provided. If you do modify the template directly, be aware that if you manually upgrade the template you will override your modifications (automatic updates aren't available for templates).

Hooks

These hooks are available for developers to further customize the extension: