Skip to content

feat: add option to control metadata indicator visibility#2214

Merged
yagebu merged 1 commit into
beancount:mainfrom
slimslickner:feat/show-metadata-indicators-option
Jul 4, 2026
Merged

feat: add option to control metadata indicator visibility#2214
yagebu merged 1 commit into
beancount:mainfrom
slimslickner:feat/show-metadata-indicators-option

Conversation

@slimslickner

Copy link
Copy Markdown
Contributor

Add a new Fava option 'show-metadata-indicators' (default: true) that allows users to disable the display of metadata indicator badges in the journal.

This addresses issue #2180 where metadata indicators were consuming valuable screen space and hiding important information like payee and narration text.

Users can now disable indicators by adding to their Beancount file:
2024-01-01 custom "fava-option" "show-metadata-indicators" "false"

The option is backward-compatible and defaults to showing indicators, maintaining existing behavior for current users.

@yagebu

yagebu commented Feb 15, 2026

Copy link
Copy Markdown
Member

This feels inconsistent: all the other visibility toggles are buttons above the journal - why differ on this one?

@slimslickner

Copy link
Copy Markdown
Contributor Author

@yagebu I had that thought too.

For me, this feels like a ledger-level decision because metadata usage would likely be consistent across a ledger. For example, if I want to see metadata values, I can still click the Journal "Metadata" toggle (or "m" keyboard shortcut) and the unfold works the same as before.

Maybe it's just my personal use case, but metadata is only useful in querying and seeing the actual values; badges for an all the metadata abbreviations isn't meaningful for me. The reason for this is 99% of transactions will have the same metadata abbreviations (either na for narration from autobean.narration or ma for match_id from zerosum). As such, the badges take up space and I already would expect the postings to have those metadata keys.

I appreciate the posting indicator dots because 1) it's something to click on to unfold a single transaction and 2) they are significantly smaller and are an easy reference to the "complexity" of a transaction. However, I could see an argument made that they should be "hide-able" too.

Regardless, I hear your concern and am open to a counter-argument.

@slimslickner

Copy link
Copy Markdown
Contributor Author

I thought of another reason why I would prefer a fava-option (or at least not in the existing pattern of toggles at the top of the Journal page). Every toggle at the top of the Journal page leads to additional or fewer rows being shown in the ledger, whereas this toggle would be the equivalent of showing/hiding columns (like show/hide tags or links or narrations).

Definitely want your thoughts and happy to change this implementation if I'm going against the fava design patterns.

@slimslickner

Copy link
Copy Markdown
Contributor Author

Copying some screenshots from the original issue.

Here's a before and after [partial] screenshot of my ledger, with the show_metadata_indicators option set to true then to false:

Image Image

@yagebu

yagebu commented Jun 16, 2026

Copy link
Copy Markdown
Member

Thanks for the work on this, I'm still a bit unsure whether this deserves to be an option, but let's go with it for now :)

@yagebu yagebu left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This option needs to be documented, then this would be ready to be merged

@slimslickner

Copy link
Copy Markdown
Contributor Author

Oops good catch. I added to src/fava/help/options.md

@yagebu yagebu force-pushed the feat/show-metadata-indicators-option branch from 1cbef51 to 3ac2f3f Compare July 4, 2026 07:26
Add a new Fava option 'show-metadata-indicators' (default: true) that allows
users to disable the display of metadata indicator badges in the journal.

This addresses issue beancount#2180 where metadata indicators were consuming valuable
screen space and hiding important information like payee and narration text.

Users can now disable indicators by adding to their Beancount file:
  2024-01-01 custom "fava-option" "show-metadata-indicators" "false"

The option is backward-compatible and defaults to showing indicators,
maintaining existing behavior for current users.
@yagebu yagebu force-pushed the feat/show-metadata-indicators-option branch from 3ac2f3f to ba77d88 Compare July 4, 2026 07:32
@yagebu yagebu merged commit ba77d88 into beancount:main Jul 4, 2026
20 checks passed
@yagebu yagebu temporarily deployed to github-pages July 4, 2026 07:35 — with GitHub Actions Inactive
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants