Sharing

Share your budget data with other Nextcloud users for household or team financial management.

Overview#

The Sharing feature allows you to grant other Nextcloud users access to your financial data. This is useful for households managing joint finances, teams tracking shared budgets, or accountants who need visibility into a client's accounts.

Nothing is shared automatically. Inviting someone opens the door; you then choose, item by item, exactly what they can see and whether they can change it.

Adding a Share#

To share your budget data with another user:

  1. Navigate to the Sharing page from the sidebar
  2. Under Share Your Budget, start typing the name, user ID or email address of the Nextcloud user you want to share with, and pick them from the matches
  3. Click Invite. They get a Nextcloud notification, which goes away once they accept or decline the invitation
  4. Once they accept, click Configure on their row to choose what they can see

An invited user starts with access to nothing. Until you pick items in Configure, they will see an empty budget.

Note: You can only share with users who have accounts on the same Nextcloud instance. The user does not need to have the Budget app enabled themselves.

Who you can pick#

The search needs at least two characters. It follows your Nextcloud administrator's sharing settings, the same ones that govern the share dialog in Files: whether users can be listed at all, whether listing is limited to people in your own groups, and whether you may only share with members of your groups. If listing users is turned off, only an exact match on a user name, display name or email address is offered, so someone you expected to see may not appear until you type their name in full. That is the administrator's setting at work, not a fault in Budget; ask them if you need to share with someone you cannot find.

Choosing What to Share#

Click Configure on a share to open its panel. It has one section per type of thing you can share:

Accounts, Categories, Bills, Recurring Income, Savings Goals, Projects and Import Rules.

Each section has its own tick list and its own permission dropdown:

PermissionDescription
Read onlyThey can see the items you tick, and use them, but not change them.
Read & WriteThey can edit the items you tick as if they were their own. Only you can delete them, and for categories some settings stay with you (see Shared Categories).
Full controlBills, Recurring Income, Savings Goals and Projects: Read & Write, plus deleting them. Categories: Read & Write, plus the settings Read & Write keeps back (type, parent, subcategories, budget and report settings), but only you can delete a category. Accounts and Import Rules don't offer Full control.

Items shared with you Read only do not offer the buttons that would change them: Edit, Delete, Duplicate, Match transfer, Mark Paid, Mark Received and Skip are not shown, and an account shared read-only has no Edit, Reconcile, Add Transaction or Import on its tile or its page. Delete on a shared bill, recurring transfer or recurring income only appears with Full control.

Important: The permission is per section, not per share. Setting Bills to Read & Write does not also grant it for Accounts — each section is set separately, and every section starts at Read only.

This catches people out in a specific way. A bill knows which account it is paid from, but that dropdown can only offer accounts the other person is allowed to see. If you share your bills without also ticking the accounts they pay from, the Pay From Account field will show nothing to choose and Auto-pay when due will not be available, because auto-pay needs an account. Sharing the accounts as well fixes both.

Auto-share new is a per-section option too: tick it and anything you create later in that section is shared automatically, at the permission the section is set to.

Giving each other equal access#

Sharing runs in one direction only. For two people to have full control of everything — a couple managing the household books together, say — each needs to share with the other: two shares, each with the sections ticked and set to Read & Write, and Categories set to Full control if you want to be able to rearrange each other's categories.

You each still own what you created, and ownership cannot be transferred. In day-to-day use that makes no difference once both shares are set up. If you genuinely need everything under one account, the only route is Settings → Data Migration: export from one account and import into the other. Be aware that importing replaces the destination's existing budget data entirely — there is no merge — so export from both sides and keep the files before you start.

Shared Accounts#

An account shared with you at Read & Write lets you record and edit transactions in it, and they are kept in the owner's ledger. That includes splitting and unsplitting them, tagging them, and bulk edit, delete and reconcile on the Transactions page, where a transaction you are not allowed to change is reported as failed with the reason and the rest go through. With Read only you can still open a split transaction and see its parts. The account itself stays with its owner: only the owner can delete it, so you do not get the delete option on an account someone has shared with you.

With Read & Write you can also reconcile the account against a statement, and change its interest rates. A reconciliation belongs to the account, so you both see the same one in progress. Its reconciliation history, interest and valuation can be read by anyone the account is shared with, Read only included.

Statements can only be imported into your own accounts, as an import runs as you rather than as the account's owner. The import screen and Bank Sync therefore only offer your own accounts, so to bring a statement into an account someone shared with you, ask its owner to import it.

As a transaction in a shared account is filed in the owner's ledger, its category has to be one the owner can use and you can see, which in practice means one of the owner's categories that they have shared with you. The category pickers on such a transaction, in its form, its split rows, bulk edit and Quick Add, only offer those. A category the transaction already has is always kept, even one the owner never shared with you. Its name still shows wherever the transaction does (the Transactions list, the account's page and the dashboard), and the transaction form shows it greyed out, as for example Food (not shared with you), and saves it back unchanged, so you can edit everything else without losing it. You just cannot choose it for another transaction. Tags work the same way: it can only take tags that you can see and that the owner can use as well, which in practice means tags from a category shared between you. The tag picker on such a transaction only offers those, and says why if a change is refused. When you change its tags, any tags the owner put on it that you cannot see are kept. Bulk Tags on the Transactions page only changes transactions in your own accounts, and counts ones in a shared account as failed.

When someone you share an account with records a transaction in it with a receipt photo attached, through the API from a capture app for example, the photo is saved in your Files, in your receipts folder, and counts against your quota, because the transaction is yours. You get a Nextcloud notification saying who added it, so a file never turns up in your Files unannounced.

Shared Categories#

Categories shared with you appear on your Categories page alongside your own, each marked with a badge naming the owner:

  • "Shared · <owner>" — read-only. You can still use the category to classify transactions, but you cannot change the category itself.

  • "Shared (editable) · <owner>" — shared with Edit permission. You can rename it and change its colour directly from the Categories page.

  • "Shared (full control)" · <owner> — shared with Full control. You can change everything about it except deleting it.

With Edit permission, some aspects of a category stay with its owner: the type (income or expense), the parent category, adding subcategories under it, the budget, whether it is excluded from reports, and deleting it. These change how the owner's budget and reports are calculated, so they remain owner-controlled. For the same reason a category shared at Edit is not offered as a parent when you add or edit one of your own categories.

Sharing a category does not share the accounts its transactions are in. Its details on the Categories page, the totals and the list of recent transactions, only count transactions in accounts you can see, so the owner's spending in accounts they have not shared with you stays private.

Full control#

If the owner sets the Categories section of the share to Full control, you can change all of those settings too, apart from deleting. This is meant for two people who run one set of categories together.

  • Subcategories: when you add a category, the categories shared with you at Full control appear in the Parent list, marked with the owner's name. A subcategory you add under one of them belongs to the owner, so it sits in their tree where they can see it, and it is shared back to you automatically.
  • Moving categories: you can move the owner's categories around within their own tree, by editing the parent or by dragging, but only under categories shared with you. A category can't be moved between two people's trees, because ownership can't be transferred, so your own categories can't go under the owner's and theirs can't go under yours. With Read & Write you can put shared categories in a different order, but moving one to another level needs Full control.
  • Budgets: on the Budget page a shared category shows the owner's budget for the month, including any adjustment they made for that month and their envelope carry-over. With Full control you can change the amount, the period and envelope budgeting there, and the change goes where the owner's own change would: into their adjustment for that month if they made one, otherwise onto the category. Without Full control these are read-only.
  • Deleting: only the owner can delete their categories. The one exception is a subcategory you added yourself, which you can delete as long as it has no subcategories and no transactions use it. Once it is in use, deleting it is the owner's call.

If the owner changes the share back to Read & Write, everything you added stays theirs, and you are back to renaming and recolouring.

If you don't want a shared category counted in your own reports, use the Hide from my reports toggle on its row (visible on hover). This affects only what you see — the owner's reports and other viewers are untouched, and the category still works for classifying transactions. Toggle it back with Show in my reports at any time.

Shared Import Rules#

You can share individual import rules the same way you share accounts or categories — pick which rules to share, at View or Edit permission, from the share's Configure panel.

A rule shared with you appears on your Rules page marked with a "Shared" badge:

  • View — you can see and run the rule, but not change it.
  • Edit — you can also modify the rule's criteria and actions. Edits apply for the owner and everyone it's shared with (it is one rule, not a copy). Only the owner can delete it.

Shared rules also run automatically when you import, and when you use Run Rule Now, exactly like your own rules.

Note on categories and accounts: a rule's actions (like set category or set account) point at the owner's categories and accounts. When such a rule runs for you, set category only takes effect if the category is also shared with you, and is skipped otherwise, so a transaction is never filed under something you can't see. Sharing the relevant categories alongside the rule makes it fully effective. Set account only ever moves a transaction between two of the rule owner's own accounts, so it never moves one of your transactions; see Set account.

With Edit permission you can change a shared rule, but an add tags action keeps any of the owner's tags in it that you cannot see. Only the tags you can see are replaced by what you save.

Shared Bills and Income#

Bills, recurring transfers and recurring income can be shared individually, at View or Edit permission, from the share's Configure panel. They appear on your Bills, Transfers and Income pages alongside your own.

  • View — you can see the bill and its schedule, but not change it or act on it.
  • Edit — you can open and edit it, mark it paid or unpaid, and skip a payment. There is one bill, not a copy: the due date advances for the owner too, and any payment transaction is recorded in the owner's account.

A bill's payment lands in the account the bill points at, which belongs to whoever owns that account. You do not need to own the account to pay a shared bill, but as paying, skipping and Mark Unpaid write to it, the account has to be shared with you at Read & Write as well as the bill, and for a recurring transfer so does its destination. The same goes for marking shared income received, or undoing that. Without write access to the account those buttons are not shown, even with Read & Write on the bill; see When Mark Paid is not offered.

As the payment is filed in that owner's ledger, a bill or recurring income paid from or into someone else's account needs a category the owner can see: one of theirs, one shared with them, or no category. The same goes for a transfer's receiving account. An account shared with you Read only isn't offered at all when you add a transaction, bill, transfer, income or rule, since nothing can be posted into it.

When you edit a bill, transfer or recurring income someone shared with you, a new category also has to be one you can see, while the categories it already uses are kept. A category it uses that is not shared with you is shown by name, greyed out, as for example Food (not shared with you), and an account that is not shared with you as Unavailable (not shared with you). Both are saved back unchanged, but you cannot choose them again.

The account works the same way in the other direction. If you move a shared bill, transfer or recurring income to another account, the new one must be an account you can post to and one its owner can use as well, so the owner can still pay it. Tags follow the category rule: a bill only takes tags you can see and its owner can use, and when it pays from or into someone else's account, that account's owner must be able to use them too.

The bill form only shows the tags you can see. When you save a bill someone shared with you, any of the owner's tags on it that you cannot see are kept, and only the ones you can see are replaced.

Note: two people sharing the same budget will not see identical Bills pages. The Payments without a recorded transaction and Suggested recurring bills cards are worked out from your own bills and transactions only, so each of you sees your own — there is nothing wrong when one of you has a card the other doesn't.

Transfers Between Shared Accounts#

A transfer can move money between any two accounts you can see, including accounts someone has shared with you at Edit permission. Both sides of the transfer are recorded in their own account, so a transfer into a shared account shows up in the owner's ledger as well as your own.

If either account is shared with you at View only, the transfer is refused — recording it would write to an account you may only read.

Matching two transactions that already exist works across the boundary in the same way. Match transfer searches every account you can write to, so money that left an account you own and landed in one shared with you at Edit can be linked as a transfer — as can the reverse. Find Transfer Matches, the bulk scan, spans the same set. Accounts shared with you at View only are not offered as candidates, since linking records the transfer on both sides.

One thing stays inside your own accounts: the automatic scan that runs after importing a bank statement only links pairs where you own both sides. A statement of yours whose counterpart sits in a shared account is left for you to match by hand, rather than the import writing a link into someone else's ledger unasked.

Managing Shares#

To view and manage your active shares:

  1. Go to the Sharing page
  2. You will see a list of all users you have shared with, and whether each share is Pending or Active
  3. To change what a person can see, click Configure and adjust the tick lists and permission dropdowns
  4. To remove access, click Revoke next to the share entry

When you remove a share, the user loses access immediately. No data is deleted from your account.

When a Share Ends#

The other person may have used your accounts and categories in their own data: a bill paid from your account, or their own transactions filed under your category. When you revoke the share, when they leave it, or when you take accounts or categories off it, their data is tidied up so it does not point at anything they have lost access to:

  • Their own transactions, bills, recurring income and import rules filed under one of the categories they lost become uncategorised.
  • Their bills, recurring income, savings goals and recurring pension payments that used one of the accounts they lost let go of it. Auto-pay and auto-post are switched off, and the payments a bill had booked ahead in your account are removed. A recurring transfer of theirs into one of those accounts cannot be paid until they edit it and choose another destination.
  • Their splits with their own shared-expense contacts are kept, and still count and can be settled.

Sharing again later works as normal, although anything that let go of an account or category has to be pointed at it again.

Changing an account from Read & Write to Read only is different, as they can still see it. Their bills keep the account, but cannot record payments in it while it is read-only. A bill with auto-pay on has it turned off, with a notification, when its next payment fails, the same as for any payment that cannot be recorded.

Warning: Revoking a share cannot be undone from the shared user's perspective. They will lose access to all your budget data instantly.

Dashboard Integration#

When you receive shared access to another user's accounts, those accounts are automatically included in your Dashboard summary. This means:

  • Net Worth includes balances from shared accounts
  • Income/Expenses This Month includes transactions from shared accounts
  • Currency breakdowns reflect shared account currencies
  • Account count includes shared accounts

The Recent Transactions widget also displays transactions from shared accounts.

  • Shared Expenses - Track and split expenses with contacts
  • Settings - Configure app preferences and security
  • Projects - Share a project budget and its figures