> ## Documentation Index
> Fetch the complete documentation index at: https://docs.equa.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifications Guide

> Understanding email notifications, delivery, and troubleshooting in Equa

# Notifications Guide

> **Last Updated:** 2026-02-28
> **Audience:** End users (organization members, administrators)

***

## What This Feature Does

Equa sends email notifications to keep you informed about important events -- account verification, login links, password resets, team invitations, and administrative alerts. All notifications are delivered via email to the address associated with your Equa account.

***

## Why It Matters

Email notifications are essential for account security and team collaboration. Magic link logins, password resets, and invitation flows all depend on email delivery. Understanding what notifications you will receive and how to troubleshoot delivery issues helps you stay productive.

***

## Notification Types

Equa sends the following transactional emails:

### Authentication Emails

| Notification           | When It's Sent                              | Can Be Disabled?  |
| ---------------------- | ------------------------------------------- | ----------------- |
| **Magic link login**   | When you request a passwordless login link  | No (on-demand)    |
| **Email verification** | After account registration or email change  | No (required)     |
| **Password reset**     | When you request a password reset           | No (on-demand)    |
| **Password changed**   | After your password is successfully changed | No (confirmation) |

### Invitation Emails

| Notification                          | When It's Sent                                         | Can Be Disabled? |
| ------------------------------------- | ------------------------------------------------------ | ---------------- |
| **User invitation**                   | When you're invited to the Equa platform               | No               |
| **Organization invitation**           | When you're invited to join an organization            | No               |
| **Convertible instrument invitation** | When you're invited regarding a convertible instrument | No               |

### Administrative Emails

| Notification                    | When It's Sent                                      | Can Be Disabled? |
| ------------------------------- | --------------------------------------------------- | ---------------- |
| **Company info**                | When company information is shared via referral     | No               |
| **Contact support**             | When a support request is submitted                 | No               |
| **Admin: organization created** | When a new organization is created (sent to admins) | No               |

***

## How Email Delivery Works

### Sender Information

All Equa emails come from the configured sender address (typically `equabot@equastart.io` with the display name "Equa"). This is consistent across all notification types.

### Email Layouts

Equa uses three email layout styles:

* **Standard layout** -- Green Equa-branded header, centered content, confidentiality footer. Used for authentication emails (magic links, verification, password reset/change) and support contacts.
* **Modern layout** -- Dark header with Equa logo, Nunito Sans font, responsive mobile design. Used for invitations (user, organization, convertible).
* **Organization layout** -- Minimal branded layout. Used for admin notifications.

### Compliance BCC

Organization administrators may have a global BCC enabled, meaning a copy of every outgoing email is sent to a designated compliance address. This is configured at the server level and is not visible to individual users.

***

## Managing Your Notifications

### Updating Your Email Address

1. Navigate to **Profile > Account Settings**
2. Update your email address
3. You will receive a verification email at the new address
4. Click the verification link to confirm the change

<Tip>
  All future notifications will go to your new email address after verification is complete.
</Tip>

### Email Verification

If your email is not verified:

* You will see a prompt after logging in
* Some features may be restricted until verification is complete
* Request a new verification email if the original expired

***

## Invitation Workflow

When you receive an invitation email:

1. Open the email from Equa
2. Click the invitation link
3. If you do not have an Equa account, you will be prompted to create one
4. Once accepted, the organization appears in your dashboard

<Note>
  Invitation links expire after a set period. If your link has expired, ask the person who invited you to resend the invitation.
</Note>

***

## Design References

Design-system source for this guide: [Notifications screenshot gallery](/architecture/design-system/screenshots/notifications) and [EquaToast](/architecture/design-system/components/equa-toast), [EquaAlert](/architecture/design-system/components/equa-alert), [EquaBadge](/architecture/design-system/components/equa-badge), [EquaMenu](/architecture/design-system/components/equa-menu).

## Troubleshooting

<AccordionGroup>
  <Accordion title="I'm not receiving any emails from Equa">
    **Check these in order:**

    1. Look in your spam, junk, or promotions folder
    2. Confirm the correct email address is on your Equa account (Profile > Account Settings)
    3. Add `equabot@equastart.io` (or your organization's configured sender) to your contacts
    4. Check if your email provider or corporate firewall is blocking the domain
    5. If you use Gmail, check the "All Mail" label -- some filters may archive Equa emails
  </Accordion>

  <Accordion title="My verification email expired">
    Log in to your account. You will see a prompt to resend the verification email. Click it to receive a fresh link. Verification codes have a limited validity period.
  </Accordion>

  <Accordion title="My magic link isn't working">
    Magic links expire after a set time. If the link has expired:

    1. Go back to the login page
    2. Request a new magic link
    3. Use the link from the **most recent** email (previous links are invalidated)
  </Accordion>

  <Accordion title="My invitation link doesn't work">
    Invitation links can expire or be revoked:

    1. Check if you are clicking the link from the most recent invitation email
    2. Ask the person who invited you to check the invitation status
    3. They may need to resend the invitation if it has expired
  </Accordion>

  <Accordion title="Getting unexpected emails from Equa">
    If you receive emails you did not expect:

    1. Check if an organization administrator invited you
    2. Verify that no one else has access to your account (change your password)
    3. Contact Equa support if you believe the emails are unauthorized
  </Accordion>
</AccordionGroup>

***

## For Administrators

### Global BCC

Server administrators can configure a `GLOBAL_BCC` address to receive copies of all outgoing emails for compliance or auditing purposes. This is a comma-separated list of email addresses configured at the environment level.

### Email Transport

The email transport is configured via the `EMAIL_TRANSPORTER` environment variable. See [Notification System Architecture](/architecture/notification-system) for full configuration details.

***

## Related

* [Getting Started](/guides/getting-started)
* [Profile and Settings](/guides/profile-and-settings)
* [Managing Team Members](/guides/managing-team-members)
* [Notification System Architecture](/architecture/notification-system) -- Technical details for developers