Skip to content

The Open Source DocuSign Alternative.

fix: clarify sender details setting (#3499)

Catalin Pitce6b0c426487
diff --git a/apps/docs/content/docs/users/organisations/preferences/document.mdx b/apps/docs/content/docs/users/organisations/preferences/document.mdx
index d81252325..8902ce7b0 100644
--- a/apps/docs/content/docs/users/organisations/preferences/document.mdx
+++ b/apps/docs/content/docs/users/organisations/preferences/document.mdx
@@ -28,7 +28,6 @@ To access the preferences, navigate to either the organisation or teams settings
| **Default Date Format** | Date format used for date fields and signing. |
| **Default Time Zone** | Timezone used for date fields and signing. |
| **Default Signature Settings** | Which signature types (typed, drawn, uploaded) recipients can use when signing. |
-| **Send on Behalf of Team** | Whether the sender's name appears in team emails. See [sender details](#sender-details) below. |
| **Include the Signing Certificate** | Whether the signing certificate is embedded in signed PDFs. The certificate is always available separately from the logs page. |
| **Include the Audit Logs** | Whether the audit logs are embedded in the document when downloaded. The audit logs are always available separately from the logs page. |
| **Default Recipients** | Recipients that are automatically added to new documents. Can be overridden per document. |
@@ -39,16 +38,6 @@ To access the preferences, navigate to either the organisation or teams settings
Document visibility, language, and signature settings can be overridden per document.
-### Sender Details
-
-If the **Sender Details** setting is enabled, the emails sent by the team will include the sender's name. The email will say:
-
-> "Example User" on behalf of "Example Team" has invited you to sign "document.pdf"
-
-If the **Sender Details** setting is disabled, the emails sent by the team will not include the sender's name. The email will say:
-
-> "Example Team" has invited you to sign "document.pdf"
-
## See Also
- [Document Visibility](/docs/users/documents/advanced/document-visibility) - Control who can access documents
diff --git a/apps/docs/content/docs/users/organisations/preferences/email.mdx b/apps/docs/content/docs/users/organisations/preferences/email.mdx
index 12a4b31c1..a788556a8 100644
--- a/apps/docs/content/docs/users/organisations/preferences/email.mdx
+++ b/apps/docs/content/docs/users/organisations/preferences/email.mdx
@@ -24,6 +24,23 @@ To access the preferences, navigate to either the organisation or teams settings
| **Default Email** | The sender email address used when sending documents. Requires a verified [email domain](/docs/users/organisations/email-domains). Teams can inherit from the organisation or select their own. |
| **Reply to email** | Email address used in the "Reply To" field in outgoing emails. Leave blank to inherit from the organisation. |
| **Default Email Settings** | Controls which emails are sent to recipients during document signing (e.g. signing invitations, completion notifications). Teams can inherit from the organisation or override with custom settings. |
+| **Include Sender Details** | Whether signing invitations show the individual sender's name alongside the team name. See [sender details](#sender-details) below. |
+
+### Sender Details
+
+When **Include Sender Details** is set to **Yes**, signing invitations show the individual sender's name alongside the team name:
+
+> "Example User" on behalf of "Example Team" has invited you to sign "document.pdf"
+
+When it is set to **No**, signing invitations show only the team name:
+
+> "Example Team" has invited you to sign "document.pdf"
+
+If a [custom message](/docs/users/documents/send#message-optional) has been provided while configuring the document, it replaces the default body text, but the heading still follows this setting.
+
+<Callout type="info">
+ For documents sent with a team API token, the individual sender is the user who created the token.
+</Callout>
## See Also
diff --git a/apps/remix/app/components/forms/email-preferences-form.tsx b/apps/remix/app/components/forms/email-preferences-form.tsx
index 97c597623..271d8b010 100644
--- a/apps/remix/app/components/forms/email-preferences-form.tsx
+++ b/apps/remix/app/components/forms/email-preferences-form.tsx
@@ -243,7 +243,7 @@ export const EmailPreferencesForm = ({ settings, onFormSubmit, canInherit }: Ema
className="flex-1"
canInherit={canInherit}
isInherited={field.value === null}
- label={<Trans>Send on Behalf of Team</Trans>}
+ label={<Trans>Include Sender Details</Trans>}
testId="include-sender-details"
>
<FormControl>
@@ -297,10 +297,15 @@ export const EmailPreferencesForm = ({ settings, onFormSubmit, canInherit }: Ema
<FormDescription>
<Trans>
- Controls the formatting of the message that will be sent when inviting a recipient to sign a
- document. If a custom message has been provided while configuring the document, it will be used
- instead.
+ Choose Yes to show the individual sender's name alongside the team name in signing invitations.
+ Choose No to show only the team name.
</Trans>
+ <span className="mt-2 block">
+ <Trans>
+ If a custom message has been provided while configuring the document, it replaces the default
+ body text, but the heading still follows this setting.
+ </Trans>
+ </span>
</FormDescription>
</InheritableField>
)}