ProtonMail / ProtonMail/WebClients
Feature Request: Allow custom icon images for Proton Pass items
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 5.6k
- Forks
- 715
- PR merge metrics
- No merged PRs in 30d
Description
Feature Request
Summary
Allow users to upload or assign custom icon images to items in Proton Pass, rather than being limited to the automatically generated or default icons.
Motivation
Currently, Proton Pass items display auto-detected favicons (for login items) or generic category icons. There are several cases where a custom icon would be valuable:
- Services without recognizable favicons — self-hosted apps, internal tools, or lesser-known websites often have missing or generic icons, making them hard to identify at a glance.
- Non-login items — notes, credit cards, and identity items all use the same generic icon, making it difficult to visually distinguish between them.
- Personal preference — users may want to organize their vault visually with icons that are more meaningful to them.
Proposed Behavior
- Users can optionally set a custom icon image (e.g., PNG, SVG, JPEG) on any Pass item (login, note, credit card, identity).
- The custom icon overrides the default/auto-detected icon in all views (vault list, item detail, browser extension, mobile apps).
- If no custom icon is set, the current behavior remains unchanged.
- Icons could be stored encrypted alongside the item metadata to maintain Proton's zero-access privacy model.
Considerations
- Storage limits — a reasonable max file size (e.g., 128KB) and dimensions could keep this lightweight.
- Privacy — custom icons should be end-to-end encrypted like other item data.
- Cross-platform — ideally supported across web, browser extension, and mobile clients.
Prior Art
Other password managers such as 1Password and Bitwarden support custom icons for vault items.
I'd be happy to help contribute to the implementation if the team is open to it. Looking forward to hearing your thoughts!
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
The issue names no files, tests, or entry points. Start by mapping the item model and icon rendering across the vault list, item detail, browser extension, and mobile clients; done means custom encrypted icons work on all listed item types and fall back to current icons when unset.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- react, typescript
- Domain
- frontend, mobile, security
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100