Skip to content

Conversation

@TaprootFreak
Copy link
Collaborator

@TaprootFreak TaprootFreak commented Dec 31, 2025

Problem

Email templates currently display content in a suboptimal order:

  1. First: Plain text URL link
  2. Then: Button with "or" prefix

This creates confusion because:

  • The majority of email clients support buttons
  • Users see the link first (less user-friendly) before the button (more user-friendly)
  • The "or" prefix on the button implies it's a secondary option, when it should be primary

Solution

Reorder email content to prioritize the button:

  1. First: Button (primary action)
  2. Then: Plain text URL link with "or" prefix (fallback for clients without button support)

Changes

Code changes

  • auth.service.ts - Login email: button before link
  • kyc-notification.service.ts - KYC emails (reminder, failed, missing data): button before link
  • account-merge.service.ts - Account merge request: button before link

Translation changes (de/en/pt/fr/it/es)

  • general.button - Removed "or" prefix (now primary action)
  • login.message - Added "or" prefix to link text
  • kyc.retry - Added "or" prefix to link text
  • kyc.next_step - Fixed to avoid double "or" (kept original text structure)
  • account_merge.request.message - Added "or" prefix to link text

Note: Albanian (sq) has no mail.json file and was skipped.

Verified correct order already

These notification services already had the correct button-first order and required no changes:

  • bank-tx-return-notification.service.ts
  • buy-fiat-notification.service.ts
  • buy-crypto-notification.service.ts
  • transaction-notification.service.ts
  • recommendation.service.ts

Impact

  • Improved UX for all users receiving emails across all 6 supported languages
  • Better accessibility (button is more prominent)
  • Consistent email structure across all notification types
  • Link remains available for email clients that don't support buttons

Test plan

  • Send login email and verify button appears first, link second
  • Send KYC reminder/failed/missing data emails and verify order
  • Send account merge request email and verify order
  • Verify all six languages (de/en/pt/fr/it/es) display correctly
  • Test in email clients with and without button support

Currently, emails display the URL link first, followed by the button.
This creates a poor user experience as most users can see buttons,
making the link redundant for the majority.

Changes:
- Reorder email content to show button first, then link
- Update all translations (de/en/pt) to reflect new order
- Add "or" prefix to link text to indicate it's a fallback option

Affected emails:
- Login email (auth.service.ts)
- KYC reminder, failed, and missing data emails (kyc-notification.service.ts)
- Account merge request email (account-merge.service.ts)

This improves UX by prioritizing the primary action (button) and
making the plain-text link available only for clients that don't
support buttons.
@TaprootFreak TaprootFreak force-pushed the fix/email-button-link-order branch from 587ae9c to e7dce33 Compare December 31, 2025 11:55
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