Budget Goal Templates
This is an experimental feature. That means we’re still working on finishing it. There may be bugs, missing functionality or incomplete documentation, and we may decide to remove the feature in a future release. If you have any feedback, please open an issue or post a message in the Discord.
All functionality described here may not be available in the the latest stable release. Use the edge
images for the latest implementation.
Create a template by adding a note to a category and adding a line that begins with #template
.
You are welcome to have other lines in your note, but the #template line must match the syntax.
How to use the templates
Syntax | Description | Application |
---|---|---|
#template $50 | Budget $50 each month | Regular monthly bills, such as internet |
#template up to $150 | Budget up to $150 each month, and remove extra funds over $150 | Variable expenses, such as petrol and groceries |
#template up to $150 hold | Budget up to $150 each month, but retain any funds over $150 | Variable expenses that may get refunds or reimbursments |
#template $50 up to $300 | Budget $50 each month up to a maximum of $300 | Funding rainy day categories, such as replacement shoes and bicycle repairs |
#template $500 by 2022-03 | Break down large, less-frequent expenses into manageable monthly expenses | Saving for a replacement car in a few years |
#template $500 by 2021-03 repeat every 6 months | Break down large, less-frequent expenses into manageable monthly expenses | Biannual credit card fees |
#template $500 by 2021-03 repeat every year | Break down large, less-frequent expenses into manageable monthly expenses | Annual insurance premium |
#template $500 by 2021-03 repeat every 2 years | Break down large, less-frequent expenses into manageable monthly expenses | Domain name renewal |
#template $500 by 2021-12 spend from 2021-03 | Budget $500 by December. Any spending between March and December is OK. | Christmas presents, overseas holiday, or any other expenses that I will be partially paying for before the target period ends. |
#template $500 by 2021-12 spend from 2021-03 repeat every year | ||
#template $500 by 2021-12 spend from 2021-03 repeat every 2 years | ||
#template $10 repeat every week starting 2022-01-03 | Budget $10 a week | |
#template $10 repeat every week starting 2022-01-03 up to 80 | Budget $10 a week, up to a maximum of $80 | |
#template $10 repeat every 2 weeks starting 2022-01-04 | Budget $10 fortnightly | |
#template $10 repeat every 9 weeks starting 2022-01-04 up to 30 | Budget $10 every 9 weeks, up to a maximum of $30 | |
#template 10% of Income | Budget 10% of the Income category | |
#template 15% of all income | Budget 15% of all income categories | |
#template schedule {SCHEDULE NAME} | Fund upcoming scheduled transactions over time | Monthly schedules, or larger non-monthly scheduled transacions |
#template schedule full {SCHEDULE NAME} | Fund upcoming scheduled transaction only on needed month | Small schedules that are non-monthly |
Notes
- $ sign is optional,
#template $50
and#template 50
are the same. - Other currency symbols are not supported.
- Number formats that use comma for the decimal separator are not supported (eg, 123,45). You must use 123.45.
- Thousands separators are not supported (eg, 1,234). You must use 1234.
- {SCHEDULE NAME} is defined in the Schedules editor.
- By default templates do not consider avaiable funds when being applied. Use template priorites to not budget more than is available.
- The
hold
flag can be added to any goal that uses theup to
key word.
Multiple Template Lines
You can add multiple #template
lines for a single category note. Each line will be added together.
For examples:
Budget $200/month for 3 months and $400/month for the next 3 months
#template $600 by 2021-03 repeat every 6 months
#template $1200 by 2021-06 repeat every 6 months
Streaming Services: $42.97
Netflix
#template $24.99
Disney Plus
#template $9.99
Amazon Prime
#template $7.99
$120 in February 2022, $130 in March 2022
#template $10 repeat every 2 weeks starting 2022-01-04
#template $100
Template Priorities
Templates can be given a priority flag to change the order that the templates get applied to your budget. Set a priority by adding -X
to the #template
flag. EX #template-4
will be priority level 4. Any template with a priority other than 0 will not apply more funds then are available.
Notes
- Lower priority values get run first. EX 0 is run first, then 1, then 2, etc.
- No priority flag defaults to priority 0 and is the same as a standard template.
- Negative priorities are not allowed and will result in the template being skipped.
- Default template application order is bottom to top. This also applies to within a given priority level.
- If you have multiple
schedule
orby
template lines in a single category, they will be forced to match the same priority level as the line run first.
Apply the templates
To apply the goal templates you create, enable the feature in the Settings experimental section. When the feature is on, two new options will appear in the monthly budget actions list.
Apply budget template will only fill empty cells using the templates.
Overwrite with budget template will fill in all budget cells using the templates.