# Email Settings

Noloco needs to send transactional emails to your app's users from time to time such as:

* Magic Login Links
* Password Reset emails
* Invitations (when a user is invited)
* Emails sent via [Workflows](https://guides.noloco.io/workflows/workflows/send-automated-emails)
* [Comment Notifications](https://guides.noloco.io/record-pages/record-comments#mentions)

And possibly some other instances

These emails will come from `no-reply@noloco.app` but you can customize the name that the emails are sent from

### Customize the Email From name

To customize the name that your Noloco emails are sent from, open the Email settings in your app or using this link: <https://portals.noloco.io/~/_/settings/emails> and pick a name, usually this is your brand's name, or something like *Sam from Evently*

<figure><img src="https://319575345-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifpIQWu0HCVYAt51oT%2Fuploads%2Fgit-blob-b8bedf6b70d9f4ad21efc35d7a5d87cbb9785299%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

If you want to customize the email address, you will need to [set up SMTP](https://guides.noloco.io/integrations/smtp-emails) (available as an add-on on Pro and Business plans, included on Enterprise plans)

### Invitation emails

When you add a user to your Noloco app you can trigger to send an invitation email from the User table.

Depending on whether they are a Team Member / Builder, or not they will get one of the two email invitations in your app's email settings.

The content of both of these emails can be customized to your liking using personalization tokens like `first name`, `last name` and related fields like `company > name`

#### Customer invitation email

This email will be sent to anyone without a *Team Member* role attribute and without a *Modify App* role attributed when they are invited to your app via the user table.

<figure><img src="https://319575345-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifpIQWu0HCVYAt51oT%2Fuploads%2Fgit-blob-d2b8ce8cce39266e8eace4ce0a01366961841868%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Internal Invitation Email

The internal invitation email template will be used to send to anyone who is not considered external (by the above definition).

This means, anyone with the 'Team Member' role property, or 'Modify App' role property will be sent this email, which you can customize from the Email settings page

<figure><img src="https://319575345-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifpIQWu0HCVYAt51oT%2Fuploads%2Fgit-blob-32aced02db14ff2baf6ef5464c045918bbe07679%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Troubleshooting Email Delivery

### Password Reset Email Issues

#### How to Send a Password Reset Email

**For individual users**:

1. Go to the User tab: <https://portals.noloco.io/~/_/users>
2. Find the user who needs a password reset
3. Click the menu button (three dots) next to their name
4. Select "Send password reset email"

**For users who request it themselves**:

* Users can visit your app's login page
* Click "Forgot your password?" link
* Enter their email address to receive reset instructions

#### Password Reset Emails Not Being Received

**Common causes and solutions**:

1. **Check spam/junk folders**: Password reset emails often get filtered by email providers
2. **Verify email address**: Ensure the email address in the user record is correct and properly formatted
3. **Email delivery delays**: Sometimes emails can take 5-10 minutes to arrive
4. **Corporate email filters**: Some organizations block automated emails

### Magic Link Delivery Issues

**If magic links aren't working**:

1. **Check spam/junk folders**: Magic link emails often get filtered by email providers
2. **Check with IT department**: Ask if automated emails from `noloco.app` domain are being blocked
3. **Whitelist Noloco domains**: Add `noloco.app` and `*.noloco.app` to email whitelist
4. **Test with personal email**: Try sending magic link to a personal email to confirm it's not a user-specific issue
5. **Use password login**: Enable password-based login as a backup option

#### Corporate Phishing System Compatibility

1. **Work with IT team**: Share this information with your IT department:
   * Magic links are generated with enhanced security tokens
   * Links expire after a short time for security
   * All links originate from verified Noloco domains
2. **Configure email security settings**:
   * Whitelist `no-reply@noloco.app` as a trusted sender
   * Allow links from `*.noloco.co` and `*.noloco.app` domains
   * Configure link scanning to not modify Noloco URLs
3. **Alternative solutions**:
   * Switch to password-based authentication if magic links are consistently blocked
   * Use [SMTP configuration](https://guides.noloco.io/integrations/smtp-emails) to send emails from your own domain

### SMTP Add-on Information

#### Purchasing SMTP Add-on

**Where to purchase**: SMTP availability varies by plan:

* **Free Plan**: SMTP not available
* **Starter Plan**: SMTP not available
* **Pro Plan**: SMTP available as an add-on (purchase on [billing page](https://portals.noloco.io/~/_/settings/billing))
* **Business Plan**: SMTP available as an add-on (purchase on [billing page](https://portals.noloco.io/~/_/settings/billing))
* **Enterprise Plan**: SMTP configuration included

**How to set up SMTP**:

1. **For Pro/Business plans**: Purchase the SMTP add-on on your [billing page](https://portals.noloco.io/~/_/settings/billing)
2. **For Enterprise plans**: SMTP is already included in your plan
3. Follow the [SMTP setup guide](https://guides.noloco.io/integrations/smtp-emails)
4. Configure your email provider's SMTP settings

**Benefits of SMTP setup**:

* Send emails from your own domain (e.g., `noreply@yourcompany.com`)
* Better deliverability through corporate email systems
* Branded email experience for your users
* Bypass some phishing system restrictions

### Email Delivery Best Practices

#### For Better Deliverability

1. **Use SMTP with your own domain** when possible
2. **Keep user email addresses current** and properly formatted
3. **Monitor email bounces** and remove invalid addresses
4. **Work with IT teams** to whitelist Noloco domains
5. **Test email delivery** regularly with different email providers

#### When to Contact Support

* Emails consistently not delivered across multiple users
* Magic links not working despite troubleshooting
* SMTP configuration not working after following setup guide
* Need help with enterprise email security configurations

{% hint style="info" %}
Most email delivery issues are resolved by checking spam folders and working with IT teams to whitelist Noloco domains.
{% endhint %}

{% hint style="warning" %}
If switching from magic links to passwords due to email delivery issues, make sure to inform your users about the change and provide clear login instructions.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.noloco.io/settings/email-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.