# Subscribers

> The Subscribers page is the main workspace for your Subscriber list. Use it to search Subscribers, filter Subscribers by status, run bulk actions, import and export CSV files, and review source-specific Subscriber history.

- Human page: https://mailrith.com/docs/subscribers
- Markdown page: https://mailrith.com/docs/subscribers.md
- Category: Subscriber Management
- Reading time: 12 min read
- Last updated: 2026-07-13
- Related keywords: Subscribers, Subscribers documentation, Subscriber Management, Subscriber Management documentation, Mailrith documentation, Mailrith help, Subscriber Directory, Create and Edit Subscribers, Subscriber Data Requests, Imports, Exports, and Bulk Actions, History and API, Subscriber Imports, Exports, and Bulk Actions, Custom Fields, Tags

## AI Agent Notes
- Use this article as step-by-step Mailrith product guidance, not as legal, financial, or deliverability advice unless the article says so.
- Preserve exact Mailrith UI labels from the steps when explaining a workflow.
- Prefer Mailrith's product term Subscribers when referring to people on an email list.

## What this guide covers
Add or import Subscribers, search and filter records, apply bulk updates, and review email, form, sequence, automation, and link history.

## Sections
- Subscriber Directory
- Create and Edit Subscribers
- Subscriber Data Requests
- Imports, Exports, and Bulk Actions
- History and API

## Visual Reference
![Mailrith subscribers page showing the subscriber table with search and filter controls.](https://mailrith.com/docs/screenshots/subscribers.png)

The subscriber list supports real-time search, status filtering, and bulk selection — making it practical to manage both small and very large contact lists from a single view.

## Subscriber Directory

Use the Subscribers page to manage the people in the current workspace subscriber list. From this page, you can search for subscribers, check each subscriber status, open profiles, apply tags, review activity, and make bulk changes with care.

Each subscriber belongs to one workspace. If you manage more than one workspace, check the workspace switcher before you add, edit, import, export, or delete subscribers. The correct workspace is the one that should own those subscriber records.

If Mailrith shows a plan-limit message for active subscribers, follow the upgrade prompt before adding more active subscribers to the workspace. Subscribers with a non-active status do not count toward active subscriber limits.

The list supports both small and large subscriber lists. Use search when you know a subscriber name or email address. Use status filters when you want to review list health. Use pagination to move through the list instead of loading every subscriber at once.

1. Click **Subscribers** in the left sidebar to open the Subscribers page for the current workspace.
2. Check the workspace name in the left sidebar before making changes. If the workspace is not the one you want, open the workspace switcher and choose the correct workspace.
3. Use the **Search subscribers** box to find a subscriber by name or email address.
4. Use the status filter when you want to show only **Active Subscribers**, **Unconfirmed Subscribers**, **Unsubscribed Subscribers**, **Bounced Subscribers**, **Complained Subscribers**, **Blocked Subscribers**, or another listed status group.
5. To filter by tag, open the status filter, choose **Tag**, choose **has any of** or **has none of**, then select one or more tags.
6. To filter by sequence, open the status filter, choose **Sequence**, choose the sequence condition you need, then select one or more sequences.
7. Click a subscriber row to open the subscriber drawer. Use **Details** to review and edit profile data, tags, custom fields, active sequences, and completed sequences. Use **History** to review email engagement, form and landing page submissions, magic links, sequence activity, and automation activity for that subscriber.
8. Use pagination to move through large subscriber lists instead of trying to load every subscriber at once.
9. When you need to target the same subscriber group more than once, create a [Segment](https://mailrith.com/docs/segments.md) instead of rebuilding the same filters each time.

Subscriber status controls whether a subscriber can receive normal marketing email:

- **Active:** the subscriber can receive broadcasts, sequence emails, and automation emails when the subscriber matches the send rules.
- **Unconfirmed:** the subscriber has not completed the required confirmation step, often because double opt-in is enabled.
- **Unsubscribed:** the subscriber opted out and should not receive marketing emails.
- **Bounced:** the email delivery service reported that the address cannot receive email. Mailrith excludes bounced subscribers from future sends.
- **Complained:** the subscriber marked an email as spam. Mailrith excludes complained subscribers to protect deliverability.
- **Blocked:** the subscriber has been intentionally prevented from receiving normal sends.

To learn how these statuses affect sending, read [Suppression Lists and Subscriber Status](https://mailrith.com/guides/suppression-lists.md), [Bounces](https://mailrith.com/guides/bounces.md), and [Spam Complaints](https://mailrith.com/guides/spam-complaints.md).

## Create and Edit Subscribers

Use **Create Subscriber** to add one subscriber manually. Manual creation works best for small corrections, test contacts, internal reviewers, or one-off subscribers that you do not add through a form or CSV import.

1. Click **Subscribers** in the left sidebar to open the Subscribers page for the workspace where you want to add the subscriber.
2. Click **Create Subscriber** in the page header.
3. In the **Create Subscribers** drawer, click **One Subscriber**.
4. In the **Create Subscriber** drawer, enter the subscriber's **Email** address and **Name**.
5. Use **Subscribed On** only when the subscriber record needs to show a specific signup date.
6. Choose the correct **Status**. Use **Active** only when the person is allowed to receive normal marketing sends.
7. Apply any relevant [Tags](https://mailrith.com/docs/tags.md), such as source, interest, or internal review labels.
8. Choose any **Sequences** you want the subscriber to enter immediately. Choose a sequence only when the sequence is ready to send.
9. Fill useful [Custom Fields](https://mailrith.com/docs/custom-fields.md) when the field values will help with segments, personalization, or reporting.
10. Click **Save**.
11. If Mailrith shows a plan-limit message while you save an Active subscriber, follow the upgrade prompt or change existing active subscribers to a non-active status.
12. After the drawer closes, use the **Search subscribers** box to find the saved subscriber record. Confirm that the profile, tags, custom fields, and subscriber history show the expected information.

A subscriber record can include a name, email address, status, tags, sequence membership, and custom field values. Fill only the information you know, and use consistent custom field values when you plan to use those fields for targeting later. For example, a "Plan" custom field is useful only when every subscriber record uses the same naming pattern for plan values.

Mailrith uses the email address as the unique subscriber identity inside a workspace. If a subscriber with the same email address already exists, update the existing subscriber record instead of creating a duplicate. This keeps subscriber history, tags, and consent status in one place.

To edit a subscriber, click the subscriber row in the directory. In the **Edit Subscriber** drawer, use **Details** to edit basic profile information, tags, active sequences, and custom fields, and to review completed sequences. Completed sequences are shown for reference and cannot be changed from this field. Use **History** to troubleshoot email engagement, form and landing page submissions, magic link clicks, sequence activity, and automation activity.

Be careful when you change status manually. Reactivate a subscriber who unsubscribed or complained only when you have a clear reason and permission to email that person again.

If you are not sure whether a subscriber should be reactivated, review [Keep Permission and Compliance Simple](https://mailrith.com/guides/permission-and-compliance.md) before changing the status.

## Subscriber Data Requests

Mailrith does not show a separate Privacy tab in the subscriber drawer. Use the subscriber details, activity history, unsubscribe state, and exports to answer routine subscriber questions. Contact Mailrith support when the request needs Mailrith's internal privacy process.

1. Click **Subscribers** in the left sidebar.
2. Use **Search subscribers** to find the subscriber by name or email address.
3. Click the subscriber row to open the **Edit Subscriber** drawer.
4. Use **Details** to review or update the subscriber's email, name, custom fields, tags, and status.
5. Use **History** to review recent subscriber activity.
6. Use subscriber export or delete actions only when your team has verified the requester and the normal Subscriber action fully matches the request.
7. For a Subscriber access request, right-to-be-forgotten request, processing restriction, objection, DPA or legal question, or security incident question, email **support@mailrith.com** with the workspace name, Subscriber email address, request type, verification status, and due date.
8. Review connected providers you chose, such as email delivery services, webhooks, Zaps, CRMs, AI providers, or internal systems, because Mailrith cannot erase or export data inside those outside accounts for you.

A normal Subscriber delete removes the record from your list. A privacy erasure request may also need Mailrith to suppress the address from future sending, remove retained Mailrith records where appropriate, and keep limited support notes. Mailrith does not replace your legal review process.

## Imports, Exports, and Bulk Actions

Use imports to add or update many subscribers at once. The import flow lets you upload a CSV file, map CSV columns to Mailrith fields, apply tags, and optionally enroll imported subscribers in a sequence.

1. Prepare your CSV with one email column and one header row.
2. Create any custom fields and tags you need before starting the import.
3. Click **Subscribers** in the left sidebar, then click **Create Subscriber** in the page header.
4. In the **Create Subscribers** drawer, click **CSV Import**.
5. In the **CSV Import** drawer, upload the CSV file, map the email column to **Email**, map useful columns to **Name** or custom fields, choose any optional tags or sequence enrollment, and click **Import**.
6. After the import finishes, filter by the import tag or use **Search subscribers** to find a few sample subscribers. Confirm that the subscriber records show the expected email addresses, names, tags, and custom field values.
7. Use export only after you set the search, status, tag, sequence, segment, or cold-subscriber filters that should be included in the file. Confirm the table shows the subscribers you want to export, then select the rows, open **Bulk Actions**, and choose **Export**.

- **Prepare your CSV:** include one email column, use clear column names, choose the duplicate CSV row with the correct details or merge needed details into one row before removing the extra duplicate rows, and keep tag or field values consistent.
- **Map columns carefully:** connect each CSV column to the correct Mailrith field. If a CSV column contains information you do not need, leave that column unmapped instead of creating unnecessary fields.
- **Apply tags during import:** add source, campaign, event, or interest tags so the imported subscribers are easy to target immediately.
- **Confirm consent before importing:** import only people who belong in the workspace and who you are allowed to contact.

Exports use the current search and filter context. If you filter to Active subscribers and then export, Mailrith exports only that filtered set, not every subscriber in the workspace. This makes exports useful for handoffs, audits, reporting, and backup snapshots.

Bulk actions can change many subscriber records at once. Select individual rows or the current page, open **Bulk Actions**, then choose the action you need: **Add Tag**, **Remove Tag**, **Add to Sequence**, **Remove from Sequence**, **Export**, or **Delete**. Before you confirm the bulk action, check that the selected count and current filters match the subscriber records you intend to change.

For a deeper walkthrough of CSV preparation, mapping, background import jobs, exports, and bulk safety checks, read [Subscriber Imports, Exports, and Bulk Actions](https://mailrith.com/docs/subscriber-imports-exports.md).

## History and API

Check subscriber history first when you need to understand what Mailrith sent to a subscriber or how the subscriber interacted with your signup and email flows. History is grouped by source so it stays easier to scan on large lists.

Use subscriber history to answer practical questions:

- Was a specific email sent to this subscriber?
- Did the subscriber open an email or click a link?
- Did this person submit the expected form?
- Did this person subscribe through the expected landing page?
- Is the subscriber active in a sequence, or did they complete or leave it?
- Is the subscriber active in an automation, or did they complete it?
- Did the subscriber click the magic link that was expected to update their preferences?
- Did an email show an unsubscribe, bounce, complaint, or other delivery result?

Mailrith also provides API details for teams that connect outside systems. Use the API when your website, product, CRM, checkout system, or internal tool needs to add or update subscribers without manual work. Non-technical users do not need to use the API directly, but knowing the API exists helps you send integration tasks to the right teammate.

## Related Guides
- [Subscriber Imports, Exports, and Bulk Actions](https://mailrith.com/docs/subscriber-imports-exports.md): Imports, exports, and bulk actions help you move and update large subscriber groups without editing each subscriber record manually. This guide explains how to prepare clean CSV files, map fields, monitor background import jobs, and avoid accidental broad changes.
- [Custom Fields](https://mailrith.com/docs/custom-fields.md): Custom fields define the shared data schema for your workspace. Create a custom field once, then use that field in subscriber records, forms, segmentation rules, automation conditions, and email merge variables.
- [Tags](https://mailrith.com/docs/tags.md): Tags are a fast way to categorize subscribers. Apply tags through imports, forms, automations, and magic links. Then use those tags as targeting filters anywhere you send email in Mailrith.
