Whitelabel email

Send transactional emails (welcome, password reset, alerts) from your own SMTP — your users see your domain in the From line, not Linked.Codes.

Welcome emails, password resets, scan alerts — by default they all leave from hello@linked.codes. Switch on whitelabel email and they leave from noreply@yourbrand.com (or whatever address you configure) instead. The recipient never sees Linked.Codes anywhere in the From, Reply-To, or unsubscribe footer.

Audience business owners Time 5 min Prerequisite active hosting
Hosting required for sends. You can configure SMTP credentials whenever — Email → Settings saves them happily without a hosting plan. The actual sending only fires for accounts on a hosting plan; without it, your saved settings sit ready and your sub-users keep getting platform default mail until you upgrade. See hosting plans →

What you'll need

How sending actually flows

Here's what happens when a sub-user requests a password reset on your subdomain:

How tenant-context email routes through your SMTP when whitelabel is on Sub-user "Reset my password" Linked.Codes Reads tenant SMTP creds Renders template Hands off via your SMTP Your mailbox noreply@yourbrand.com Sends from your IP (your reputation) to inbox
Linked.Codes orchestrates the send but doesn't put its name on the envelope. Your SMTP signs and ships.

How to set it up

  1. Get SMTP credentials from your mail provider.

    Most providers expose them in their account dashboard. The four you need: host, port, user (your full mailbox address), and password (the mailbox password or an app-specific password).

Namecheap private email
mail.privateemail.com · port 587 (STARTTLS) or 465 (SSL).
Gmail / Google Workspace
smtp.gmail.com · port 587. Generate an app password under Google account → Security → 2-step verification → App passwords.
Postmark
smtp.postmarkapp.com · port 587. User + password are both your Server API token.
AWS SES
email-smtp.<region>.amazonaws.com · port 587. Generate SMTP credentials under SES → SMTP settings.
Fastmail
smtp.fastmail.com · port 465 (SSL). Generate an app-specific password under Settings → Privacy & Security → App passwords.
  1. Open Email → Settings and paste the credentials.

    The SMTP block sits at the top of the Settings card. Here's what it looks like:

SMTP — primary transport
SMTP host
Port
Secure (TLS)
SMTP user
SMTP password
Test connection
The [Settings → SMTP](/app/emails/settings) block. Click Test connection to run an EHLO + AUTH session before saving.
From address has to match the SMTP user. Most providers reject sends with a 553 error if your From email is different from the authenticated mailbox. If you authenticate as noreply@yourbrand.com, your From email must be the same address (or a configured alias on that mailbox).
  1. Set the sending identity.

    Below the SMTP block, set your From email + From name. The From email must match the SMTP user above. Reply-to is optional — leave empty to default to From.

  2. Send a test.

    At the bottom of the Settings card, drop your own email into the test-send field. Test sends bypass the Whitelabel toggle and the hosting gate, so you can verify the loop before flipping anything live.

Send a test email
Confirms delivery from your mailbox to a real inbox. Doesn't write to Activity.
Send test Sent — check your inbox
The send-test block at the bottom of Email → Settings. Result text turns green on success, red on failure.
  1. Flip the Whitelabel toggle on.

    The toggle sits at the very top of Email under the tab bar. Once on (with hosting active + creds saved), every transactional email to your sub-users ships from your SMTP. The Active transport pill flips to Whitelabel SMTP · <your host>.

Whitelabel email — send from your own address
When on, welcome / password-reset / alert emails to your users ship from your own SMTP, not Linked.Codes.
On
The master toggle at the top of Email. Visible on every tab; one switch controls every tenant-routed send.
Ready? Configure now.
Five minutes from "open settings" to "your sub-users get mail from your domain".
Open Settings

What gets sent from your SMTP

Currently routed through tenant SMTP when the toggle is on:

Welcome — sub-user signup
Triggered when a new sub-user signs up on your tenant subdomain. Uses your welcome_user template.
Password reset
Triggered when a sub-user requests a reset from your tenant subdomain. Uses your forgot_password template.

Everything else (notifications about your own Linked.Codes account, billing receipts, hosting alerts) keeps coming from hello@linked.codes because those are between Linked.Codes and you, not between you and your users.

Why your reputation matters

Whitelabel email isn't just a branding lever. The sending domain accumulates reputation over time — Gmail, Outlook, Yahoo all track which domains send legitimate mail at scale. If your platform sends 5,000 password resets a month and they all open and click, that signal accrues to your domain. Recipients trust mail from your domain because they've seen it before.

The opposite is the trap with shared shortener-style mailers: when one tenant fires a bulk outreach campaign and gets flagged, every other tenant on that pool eats the deliverability cost. Whitelabel SMTP keeps your reputation isolated.

Templates

Open the Templates tab on the same page to override the default subject + body for any transactional email. Save a tenant override and it ships from your account; revert and you fall back to the Linked.Codes default. Variables like {{first_name}}, {{reset_url}}, {{app_url}} interpolate at send time — full list visible in the editor for each template.

Activity log

The Activity tab shows every email your account sent — to whom, which template, status (sent / failed / bounced), timestamp. Filter by status to find failures fast.

Troubleshooting

"Sender address rejected: not owned by user X". Your From email doesn't match the authenticated SMTP user. Either change the From to match the SMTP user, or add the From address as an alias on the mailbox.
"Connection timed out" on Test connection. Usually a wrong port (try 587 for STARTTLS or 465 for SSL), or your provider blocks SMTP from outside their network. Check the provider's docs for the exact host + port.
Saved but emails still come from hello@linked.codes. Check the Whitelabel toggle is ON, hosting is active, and all four SMTP fields are filled. The connection-card pill says "Whitelabel SMTP · <host>" when everything's lined up. If it says "Linked.Codes platform" instead, one of those is missing.