starred/documenso

Fork 0

mirror of https://github.com/documenso/documenso.git synced 2026-04-24 21:36:01 +03:00

[GH-ISSUE #2341] UI copy: make email settings labels easier to understand #662

New issue

Closed

opened 2026-02-26 18:47:58 +03:00 by kerem · 4 comments

kerem commented

2026-02-26 18:47:58 +03:00

Owner

Originally created by @tinymachine on GitHub (Dec 19, 2025).
Original GitHub issue: https://github.com/documenso/documenso/issues/2341

Originally assigned to: @LouisLau-art on GitHub.

Describe the improvement you are suggesting in detail

I find the language used for the email settings confusing. I may not be alone, given that each setting has its own tooltip to better explain what it means. Without the tooltip content, it's not clear who's receiving the emails, and what exactly the recipients are being informed of.

Rewording the labels for the settings and ordering them more logically will make these settings much easier to use, and obviate the need for the tooltips.

Here's one way they could be reworded — the proposed labels are a bit longer, but much clearer:

Current labels	Proposed labels
Send recipient signed email	Email the owner when a recipient signs
Send recipient signing request email*	Prefer email over generating links when sharing documents
Send recipient removed email	Email the recipients when they’re removed from pending document
Send document pending email	Email the recipient who just signed if document is still pending
Send document completed email	Email the recipients when document is completed
Send document deleted email	Email the recipients when pending document is deleted
Send document completed email to the owner	Email the owner when document is completed

*I think either this setting is unnecessary or the way generating links works in the UI is more complicated than it needs to be.

Then the settings could be reordered more logically:

✅ Email the owner when a recipient signs
✅ Email the owner when document is completed
✅ Email the recipient who just signed if document is still pending
✅ Email the recipients when document is completed
✅ Email the recipients when they’re removed from pending document
✅ Email the recipients when pending document is deleted
✅ Prefer email over generating links when sharing documents

Additional Information & Alternatives (optional)

No response

Do you want to work on this improvement?

Yes

Please check the boxes that apply to this improvement suggestion.

I have searched the existing issues and improvement suggestions to avoid duplication.
I have provided a clear description of the improvement being suggested.
I have explained the rationale behind this improvement.
I have included any relevant technical details or design suggestions.
I understand that this is a suggestion and that there is no guarantee of implementation.

Originally created by @tinymachine on GitHub (Dec 19, 2025). Original GitHub issue: https://github.com/documenso/documenso/issues/2341 Originally assigned to: @LouisLau-art on GitHub. ### Describe the improvement you are suggesting in detail I find the language used for the email settings confusing. I may not be alone, given that each setting has its own tooltip to better explain what it means. Without the tooltip content, it's not clear who's receiving the emails, and what exactly the recipients are being informed of. Rewording the labels for the settings and ordering them more logically will make these settings much easier to use, and obviate the need for the tooltips. Here's one way they could be reworded — the proposed labels are a bit longer, but much clearer: | Current labels | Proposed labels | |------------|-------------| | Send recipient signed email | Email the owner when a recipient signs | | Send recipient signing request email* | Prefer email over generating links when sharing documents | | Send recipient removed email | Email the recipients when they’re removed from pending document | | Send document pending email | Email the recipient who just signed if document is still pending | | Send document completed email | Email the recipients when document is completed | | Send document deleted email | Email the recipients when pending document is deleted | | Send document completed email to the owner | Email the owner when document is completed | *_I think either this setting is unnecessary or the way generating links works in the UI is more complicated than it needs to be._ Then the settings could be reordered more logically: ✅ Email the owner when a recipient signs ✅ Email the owner when document is completed ✅ Email the recipient who just signed if document is still pending ✅ Email the recipients when document is completed ✅ Email the recipients when they’re removed from pending document ✅ Email the recipients when pending document is deleted ✅ Prefer email over generating links when sharing documents ### Additional Information & Alternatives (optional) _No response_ ### Do you want to work on this improvement? Yes ### Please check the boxes that apply to this improvement suggestion. - [x] I have searched the existing issues and improvement suggestions to avoid duplication. - [x] I have provided a clear description of the improvement being suggested. - [x] I have explained the rationale behind this improvement. - [x] I have included any relevant technical details or design suggestions. - [x] I understand that this is a suggestion and that there is no guarantee of implementation.

kerem

2026-02-26 18:47:58 +03:00

closed this issue
added the
good first issue

type: enhancement

apps: web

community

component: ui

effort: low
labels

kerem commented

2026-02-26 18:47:58 +03:00

Author

Owner

@coderabbitai[bot] commented on GitHub (Dec 19, 2025):

📝 CodeRabbit Plan Mode

Generate an implementation plan and prompts that you can use with your favorite coding agent.

Create Plan

Examples

🔗 Similar Issues

Related Issues

🔗 Related PRs

documenso/documenso#1138 - chore: rename "none" document access to "no restrictions" [merged]
documenso/documenso#1179 - fix: add correct role names for direct templates [merged]
documenso/documenso#1215 - feat: send custom email to signers of direct template documents [merged]
documenso/documenso#1534 - feat: add controls for sending completion emails to document owners [merged]
documenso/documenso#2030 - feat: improve invite email [merged]

👤 Suggested Assignees

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord or schedule a call!

@coderabbitai[bot] commented on GitHub (Dec 19, 2025):  ### 📝 CodeRabbit Plan Mode Generate an implementation plan and prompts that you can use with your favorite coding agent. - [ ]  Create Plan <details> <summary>Examples</summary> - [Example 1](https://github.com/coderabbitai/git-worktree-runner/issues/29#issuecomment-3589134556) - [Example 2](https://github.com/coderabbitai/git-worktree-runner/issues/12#issuecomment-3606665167) </details> --- <details> <summary>🔗 Similar Issues</summary> **Related Issues** - https://github.com/documenso/documenso/issues/2029 - https://github.com/documenso/documenso/issues/2140 - https://github.com/documenso/documenso/issues/1552 </details> <details> <summary>🔗 Related PRs</summary> documenso/documenso#1138 - chore: rename "none" document access to "no restrictions" [merged] documenso/documenso#1179 - fix: add correct role names for direct templates [merged] documenso/documenso#1215 - feat: send custom email to signers of direct template documents [merged] documenso/documenso#1534 - feat: add controls for sending completion emails to document owners [merged] documenso/documenso#2030 - feat: improve invite email [merged] </details> <details> <summary>👤 Suggested Assignees</summary> - [samuel-cglg](https://github.com/samuel-cglg) - [NDCallahan](https://github.com/NDCallahan) - [Reberg](https://github.com/Reberg) - [raikasdev](https://github.com/raikasdev) - [dguyen](https://github.com/dguyen) </details> --- <details> <summary> 🧪 Issue enrichment is currently in open beta.</summary> You can configure auto-planning by selecting labels in the issue_enrichment configuration. To disable automatic issue enrichment, add the following to your `.coderabbit.yaml`: ```yaml issue_enrichment: auto_enrich: enabled: false ``` </details> 💬 Have feedback or questions? Drop into our [discord](https://discord.gg/coderabbit) or [schedule a call](https://calendly.com/parth-coderabbit/issues-feedback)!

kerem commented

2026-02-26 18:47:59 +03:00

Author

Owner

@hellrae commented on GitHub (Dec 20, 2025):

Yeah, this totally makes sense!!
I was also confused when I read the current labels

It's probably better to wait for the maintainers to take a look and decide on a course of action, but I agree that the descriptions should be improved.

@hellrae commented on GitHub (Dec 20, 2025): Yeah, this totally makes sense!! I was also confused when I read the current labels It's probably better to wait for the maintainers to take a look and decide on a course of action, but I agree that the descriptions should be improved.

kerem commented

2026-02-26 18:47:59 +03:00

Author

Owner

@catalinpit commented on GitHub (Feb 5, 2026):

Solid suggestion! If anyone wants to pick this, feel free to do so. Just take into consideration the tooltips too, please.

@catalinpit commented on GitHub (Feb 5, 2026): Solid suggestion! If anyone wants to pick this, feel free to do so. Just take into consideration the tooltips too, please.

kerem commented

2026-02-26 18:47:59 +03:00

Author

Owner

@LouisLau-art commented on GitHub (Feb 5, 2026):

I picked this up and opened a PR updating the English checkbox labels + reordering the list (and adjusting the E2E tests accordingly): https://github.com/documenso/documenso/pull/2448

@LouisLau-art commented on GitHub (Feb 5, 2026): I picked this up and opened a PR updating the English checkbox labels + reordering the list (and adjusting the E2E tests accordingly): https://github.com/documenso/documenso/pull/2448

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

starred/documenso#662

No description provided.

Rows
Columns