Skip to content
This repository was archived by the owner on Nov 18, 2025. It is now read-only.

Conversation

@Juulz
Copy link
Contributor

@Juulz Juulz commented Oct 18, 2025

I am unable to upload images from my fork. They are here:
images

Updated Credit Cards:

  • Rewrote index.md to explain how Actual treats credit cards
  • Split off Paying in Full - Within the Budget and rewrote with screenies
  • Rewrote Carrying debt with screenies

Please add Citi and Citibank to allowed words. Thank you.

Juulz added 2 commits October 27, 2025 10:50
Fixed spelling error
Fixed spelling error.
@github-actions

This comment has been minimized.

@github-actions

This comment has been minimized.

Replaced willy-nilly and removed woot.
@github-actions

This comment has been minimized.

Fixed Spelling
@Juulz
Copy link
Contributor Author

Juulz commented Oct 27, 2025

Please add Citi and Citibank to allowed words. There is really no replacement in the examples. Otherwise this is ready to go.

@Juulz Juulz marked this pull request as ready for review October 27, 2025 15:09
@actual-github-bot actual-github-bot bot changed the title [WIP] Update Credit Card Section Fixes #742 Update Credit Card Section Fixes #742 Oct 27, 2025
@actual-github-bot actual-github-bot bot added 🔍 ready for review Someone needs to look into this. and removed 🚧 WIP labels Oct 27, 2025
@github-actions

This comment has been minimized.

@Juulz
Copy link
Contributor Author

Juulz commented Nov 5, 2025

Line breaks fixed. All checks now passing.

# Carrying Debt

Carrying debt on a credit card refers to the situation where you have an outstanding negative balance on the card and do not have the money set aside for paying it off in full when the next bill arrives. We highly recommend that you do _not_ do this for any new spending as it becomes super easy to accidentally fall into deeper debt. Instead, we recommend that you follow the [Within the Budget](./index.md) strategy for any new credit card purchases. But in case you're already carrying a negative balance on a credit card, this page will outline how to safely manage the debt without having to worry about going into more debt.
When you have an outstanding negative balance that you are unable to pay in full you are "carrying debt". We highly recommend that you do _not_ do this for any new spending as it becomes super easy to accidentally fall deeper into debt. Instead, we recommend that you follow the [Within the Budget](./index.md) strategy for any new credit card purchases. In case you're already carrying a negative balance on a credit card, this page will outline how to safely manage the debt without having to worry about going into more debt.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should the link here go directly to the recommendations for staying within your budget?

:::note

If you have been paying the statement balance in full every month, but need to incur debt for an emergency purchase enter the transaction normally, but categorize it as **Bank Card Debt**. Use the note field for a note or tag as to why. You can even use a split transaction if you only need to incur debt on part of the purchase!

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would recommend a different approach here. I would recommend that a person categorizes as the actual category of the spending, then covers the spending by creating debt in the CC category. That way the spending shows in its proper category and isn't lost in the catch all of the CC category. Thoughts?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The other choice is to move funds from the CC Category to the spending category to cover the transaction. AB does not let you cover overspending from an overspent category unless you do it by hand somehow - never tried it. Seems like it would cause a mess.

Otherwise, you'll have to make a dummy transaction to increase the debt.

It's so much easier to categorize the debt as debt and make a note of what was purchased.

I believe this is a limitation of the way AB handles CC debt.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Its true using the little menu option doesn't let you move from an overspent category, but you can always manually subtract funds. I don't know why that would be messy. Its the same processes as budgeting, or pulling from savings to cover something

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's say you've already budgeted for your minimum payment. You would negate that by subtracting? I don't want to explain why that should be done to someone living paycheck to paycheck. Better to categorize it as debt - that's the important part. Another option would be to split the transaction, even if one half is ZERO to the category as a placeholder (but I wouldn't put that in a document).

Actually, I think the current docs allude to using the debt category for new debt.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The note says its for people that have been paying off their card every month. I think for those people it makes more sense to add new debt vs directly charging to the CC category.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think writing a how-to on covering spending from a negative rollover category might be beyond this document? At least it's beyond me at this point. If there is already documentation on how to do it, we can point to it to create new debt. The current doc notes that carried debt is categorized as the CC category.

Although, if you know how you might wanna write it, you maintainers can choose to change it however you see fit. I really don't mind at all. XD

I have added in an OR to include that the payment is the difference between account balance and category balance and shown in the example that it is the same.

As an aside... I think I understand why nYNAB chose to make a special credit card account type. ; )

- Uncleared total (Actual): $126.60 (Remember to use the absolute, positive, value)
- Budgeted column (Actual): $250.00
- Our payment calculation is:
<br /> New Purchases - Return credits + Uncleared total + Budgeted column, or
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does it really need to be this copmlicated to calculate the payment? Does this cover something that account_balance-category_balance doesn't?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here's how I explained it to Magnus in a long convo we had here: https://discord.com/channels/937901803608096828/1425149940891521076

I would be hesitant to do it that way if I were living paycheck to paycheck. It's easy to prove it will be OK if you reconcile using the statement, prove you've covered it all, use the statement numbers and you'll KNOW that it's all OK.

Perhaps a line noting that it turns out the same if you do that and the user can choose once they are comfortable?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Adding in the short version probably would be good. I worry that this new page is getting long already and having a long math equation to figure out what your payment is is just another point against people paying attention.

matt-fidd and others added 2 commits November 6, 2025 18:46
Added payment = difference between account balance and category balance.
@actual-github-bot actual-github-bot bot added ✅ approved Used in conjunction with Merge at Release. This means that the PR has been approved but not merged. and removed 🔍 ready for review Someone needs to look into this. labels Nov 7, 2025
@youngcw youngcw merged commit dbfb4e5 into actualbudget:master Nov 7, 2025
6 checks passed
@actual-github-bot actual-github-bot bot added ✨ merged and removed ✅ approved Used in conjunction with Merge at Release. This means that the PR has been approved but not merged. labels Nov 7, 2025
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants