How do I use dynamic date variables in my recurring invoice templates?
Not sure which one you're using? The new interface has a dark sidebar and /app/ in the web address; the classic interface has a bright blue sidebar. You can switch at any time: in the new interface, click your name (top right) and choose Switch back to classic; in the classic interface, hover your avatar (bottom left) and choose Try the new Harpoon.
You can add date variables to your recurring invoices. They're replaced with the right date based on the issue date of each invoice Harpoon creates.
Date variable tags
When creating or editing a recurring invoice, you can use these tags:
- {month}: Replaced with the month of the invoice's issue date (for example January, February, March).
- {year}: Replaced with the year of the invoice's issue date (for example 2026).
Where you can use them
- The Subject field.
- Line item Description fields.
- The Notes field.
For example, if you bill a client each month for web hosting, you could type this in a line item's Description:
- Hosting for {month} {year}
When the recurring invoice creates its invoice in August 2026, your client will see:
- Hosting for August 2026
Note: Each tag is filled in once per field, so use {month} and {year} at most once each in the same field. The dates are filled in on the invoice's details screen, its preview, the online invoice your client sees, and the invoice email. When you edit the recurring invoice, you'll still see the tags as you typed them.
You can add dynamic date variables to your recurring invoice templates which will automatically render the correct date based on the issue date of each generated invoice. Here's how it works:
Date Variable Tags
When creating (or editing) a recurring invoice template you can include the following date variable tags within various fields on the template:
{month} – This variable will be dynamically replaced with the “month” of the new invoice’s issue date (e.g. January, February, March, etc.).
{year} – This variable will be dynamically replaced with the “year” of the new invoice’s issue date (e.g. 2021, 2022, etc.).
Field Locations
You can add these date variable tags to the following fields when creating (or editing) a recurring invoice template:
- “Subject” field.
- Line item “Description” fields.
- “Notes” field.
For example, if you bill your client each month for web hosting fees, you might include the following within a line item "Description" field on the recurring invoice template:
- Hosting for {month} {year}
When the recurring invoice template generates its monthly invoice in August 2021 the line item "Description" field on that invoice will be rendered as:
- Hosting for August 2021
The date variable tags also work with Harpoon's available rich text editing tools, so that this:
- Hosting for {month} {year}
Will be rendered as:
- Hosting for August 2021