User manual

14. Savings goals

Back to home

14. Savings goals

The Savings Goals module helps you separate money reserved for specific targets from day-to-day spending. Each goal is linked to a dedicated virtual account that sits beneath a savings account.

What it is for

  • Track how much has been reserved for each target.
  • Limit how much of monthly positive savings can be allocated to goals.
  • Preview and approve month-close allocation.
  • Optionally create real transfer transactions during approval.

Core concepts

Roles of accounts

Account type Description
Savings account (parent) A regular, non-primary, non-virtual account that you designate as the collector for one or more goals. This is not your main spending account. You must either select an existing savings account or create a new dedicated one before creating a goal.
Virtual goal account Created automatically when a goal is saved. It holds the reserved balance for one specific goal. You cannot use it directly for transactions.
Main account Your everyday spending account. It must not be used as the parent for a savings goal.

Key relationships

  • One savings account can be the parent of multiple goals with different allocation percents.
  • In a workspace, the first savings goal lets you choose or create the parent savings account; after that, all new goals reuse the same parent account automatically.
  • The virtual goal accounts are nested under their parent savings account and display as read-only balance holders.

Other concepts

  • Goal: name, target amount, current reserved amount, allocation percent, status.
  • Allocation percent: share each active goal receives from the allocatable pool.
  • Profile cap percent: global ceiling for how much of monthly positive savings can be allocated.

Important rules

  • The parent account must be a savings account — it must be non-primary and non-virtual.
  • If no suitable savings account exists, create one in Accounts before creating a goal.
  • Sum of allocation percentages across active goals under the same parent savings account cannot exceed 100.
  • Allocation percent must be between 1 and 100.
  • Suspended and completed goals are excluded from automatic month-close distribution.
  • If monthly net savings is negative, allocatable amount is zero.

Create a goal

  1. Open the Goals page.
  2. Click New goal.
  3. Step 1 — Parent savings account:
    • This step is shown only when the workspace has no goals yet.
    • Select an existing savings account from the list (only non-primary, non-virtual accounts appear).
    • If none exists, go to Accounts, create a new account, and make sure it is not marked as primary or virtual.
  4. Step 2 — Goal details: enter goal name, target amount, and allocation percent.
  5. Optionally set an initial reserved amount (cannot exceed the parent savings account's available balance).
  6. Save; the linked virtual goal account is created automatically under the chosen savings account.

Tip: after the first goal exists, the chosen savings account is locked for the workspace and new goals will reuse it automatically.

Goal statuses

  • Active: participates in monthly distribution.
  • Suspended: temporarily excluded from distribution.
  • Completed: target reached.

Manual actions

  • Suspend / Resume: toggle participation in automatic distribution.
  • Adjust: one-time increase or decrease with a reason.
  • Change allocation percent: affects future month-close runs, not historical snapshots.

Month-close flow

  1. Preview:

    • system computes monthly net savings;
    • applies allocation cap percent;
    • calculates estimated distribution per active goal.
  2. Approve:

    • allocation is persisted;
    • goal balances are updated;
    • month snapshot is stored.
  3. Approve with transfer:

    • same as approve;
    • plus transfer transactions are created from the parent savings account to each goal's virtual account.
  4. Availability rule:

    • month-close actions are available only on the profile-configured validation day.
    • if automatic month-close is enabled in Profile, execution can run automatically on that day.

Typical validation errors

  • allocation cap is outside 0..100 or allocation percent is outside 1..100;
  • active goals allocation total under the same parent savings account would exceed 100;
  • parent account is invalid (primary or virtual) — select or create a proper savings account instead;
  • invalid month format in month-close request.

Related chapters

4. Accounts, 8. Budgets, 9. Dashboard & statistics, 13. FAQ

Table of contents
1. Introduction
CaeliBudget is a workspace-based financial management application.
3. Workspaces
A *workspace* is the isolated unit that owns your accounts, categories, transactions and tags. A user can belong to multiple workspaces (e.g. *Household*, *Business*), and every membership is bound to a **role**.
Create or edit a workspace
This page is used to create a new workspace or update the core settings of an existing one.
Workspace onboarding
This page guides you through the first setup steps of a newly created workspace.
Workspace members
This page manages the list of users who can access the workspace and their roles.
9. Dashboard
After sign-in your home screen is the **Dashboard**: a consolidated view of your workspace's balances, spending split, budgets, savings goals and most recent transactions.
4. Accounts
An *account* represents a concrete money-holding instrument inside a workspace: bank account, cash, credit card, savings, etc. Every transaction is bound to exactly one account (a transfer touches two — source and destination).
Create or edit an account
This page is used to add a new account or update the settings of an existing one.
5. Categories
Categories let you classify transactions so statistics, budgets, and exports can group them meaningfully.
Create or edit a category
This page is used to create a new category or fine-tune an existing one.
Category statistics
This page shows the detailed activity of a selected category.
4. Transactions
A transaction is the atomic unit of CaeliBudget: every income, expense or transfer is stored as one transaction.
4.1 Create a new transaction
This page is used to quickly and accurately record a new income, expense, or transfer between accounts.
Import transactions from CSV
This page is used for bulk transaction upload from a CSV file.
7. Planned transactions
A *planned transaction* is a template that either automatically generates **real transactions** at a fixed cadence, or pre-generates **planned occurrences** that you confirm before they are booked.
Planned transaction form
This page is used to define regular income, expense, or transfer rules that either generate transactions automatically or create planned occurrences for your review.
8. Budgets
A *budget* defines a cap (or target) for one category over a period of time. CaeliBudget continuously shows where you stand against it.
Budget form
This page is used to create or edit a budget linked to a category.
14. Savings goals
Tag list
This page shows all tags available in the workspace.
Create or edit a tag
This page is used to create a new tag or update an existing one.
Profile page
This page is used to manage your own user details and password.
Accessibility

Adjust display preferences for better readability and usability.

Keyboard shortcuts

A limited desktop-oriented shortcut set. Disabled by default.

Focus a field, then press Ctrl + Alt + Shift + a letter or digit. Press Backspace or Delete to clear the binding.
Active only on desktop or installed desktop PWA environments.
Full accessibility manual