# Subscribers > The Subscribers page is the operating hub for your subscriber list — search, status filtering, bulk actions, CSV imports and exports, and per-subscriber activity timelines all live here. - Human page: https://mailrith.com/docs/subscribers - Category: Subscriber Management - Reading time: 12 min read ## What this guide covers Add, import, search, filter, and bulk-update contacts while tracking a complete activity history for every subscriber. ## Sections - Subscriber Directory - Create and Edit Subscribers - 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 The Subscribers page is the main place to manage the people in a workspace subscriber list. It is where you search for contacts, check status, open profiles, apply tags, review activity, and make careful bulk changes. Each subscriber belongs to the current workspace. If you manage more than one workspace, confirm the workspace switcher before adding, editing, importing, exporting, or deleting subscribers. Free workspaces can store up to 1000 active subscribers. Non-active subscribers do not count toward this limit. Upgrade to Pro when you need to add more active subscribers to a workspace. The list is designed for both small and large subscriber lists. Use search when you know a name or email address. Use status filters when you are checking list health. Use pagination instead of trying to load every contact 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 it is wrong, open the workspace switcher and choose the workspace you want. 3. Use the **Search subscribers** box to find a person by name or email address. 4. Use the status filter when you want to review 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 whether subscribers should be active in, not active in, completed, not completed, ever been in, or never been in the sequence, 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 understand what happened over time. 8. Use pagination to move through large subscriber lists instead of trying to load every subscriber at once. 9. When you need to target a reusable subscriber group, create a [Segment](https://mailrith.com/docs/segments.md) instead of repeating the same filters manually. Subscriber status controls whether a person can receive normal marketing email: - **Active:** the subscriber can receive broadcasts, sequence emails, and automation emails when they match the send rules. - **Unconfirmed:** the subscriber has not completed a confirmation step, often because double opt-in is being used. - **Unsubscribed:** the subscriber opted out and should not receive marketing emails. - **Bounced:** the delivery provider reported that the address cannot receive email. Mailrith excludes bounced contacts from future sends. - **Complained:** the subscriber marked an email as spam. Mailrith excludes complained contacts to protect deliverability. - **Blocked:** the subscriber has been intentionally prevented from receiving normal sends. For the sending concepts behind these statuses, 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** when you need to add one person manually. This is best for small corrections, test contacts, internal reviewers, or one-off subscribers you want to add outside a form or import. 1. Click **Subscribers** in the left sidebar to open the Subscribers page for the workspace where you want to add the subscriber. 2. If the workspace is on the free plan and has reached 1000 active subscribers, new Active subscribers are blocked until you upgrade or move existing Active subscribers to a non-active status. 3. Click **Create Subscriber** in the page header. 4. In the **Create Subscribers** drawer, click **One Subscriber**. 5. In the **Create Subscriber** drawer, enter the subscriber's **Email** address and **Name**. 6. Use **Subscribed On** if you need the record to show a specific signup date. 7. Choose the correct **Status**. Use **Active** only when the person is allowed to receive normal marketing sends. 8. Apply any relevant [Tags](https://mailrith.com/docs/tags.md), such as source, interest, or internal review labels. 9. Choose any **Sequences** you want the subscriber to enter immediately. Do this only when the sequence is ready to send. 10. Fill useful [Custom Fields](https://mailrith.com/docs/custom-fields.md) if the data will help with segments, personalization, or reporting. 11. Click **Save**. 12. After the drawer closes, use the **Search subscribers** box to find the saved record and confirm the profile, tags, fields, and activity history look correct. A subscriber record can include name, email address, status, tags, sequence membership, and custom field values. Fill only what you know, but use consistent fields when the data will be used for targeting later. For example, a "Plan" custom field is only useful if the values are entered consistently. Mailrith treats the email address as the unique subscriber identity inside a workspace. If a subscriber with the same email address already exists, update the existing record instead of trying to create a duplicate. This keeps activity history, tags, and consent status in one place. To edit a subscriber, click their row in the directory. In the **Edit Subscriber** drawer, use **Details** for basic details, tags, active sequences, completed sequences, and custom fields. Completed sequences are shown for reference and cannot be changed from this field. Use **History** for troubleshooting what happened over time. Be careful when changing status manually. Reactivating someone who unsubscribed or complained should only be done when you have a clear reason and permission to email them again. If you are unsure whether a subscriber should be reactivated, review [Keep Permission and Compliance Simple](https://mailrith.com/guides/permission-and-compliance.md) before changing the status. ## Imports, Exports, and Bulk Actions Use imports when you need to add or update many subscribers at once. The import flow lets you upload a CSV file, map columns to Mailrith fields, apply tags, and optionally enroll subscribers in a sequence. 1. Prepare your CSV with one clear 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, map the email column to **Email**, map useful columns to **Name** or custom fields, choose optional tags or sequence enrollment, and click **Import**. 6. After the import finishes, filter by the import tag or use **Search subscribers** to search for a few sample subscribers and confirm the data landed correctly. 7. Use export only after setting the search, status, tag, sequence, segment, or cold-subscriber filters you want included in the file. Then select the rows, open **Bulk Actions**, and choose **Export**. - **Prepare your CSV:** include one email column, use clear column names, remove obvious duplicates, and keep tag or field values consistent. - **Map columns carefully:** connect each CSV column to the correct Mailrith field. If a column contains data you do not need, leave it unmapped instead of creating unnecessary fields. - **Apply tags during import:** add source, campaign, event, or interest tags so the new contacts 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 that filtered set, not every subscriber in the workspace. This makes exports useful for handoffs, audits, reporting, and backup snapshots. Bulk actions are powerful because they change many 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 confirming, check the selected count and filter context. 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 The subscriber activity history is the first place to look when you need to understand why something happened. It shows events such as form submissions, tag changes, sequence enrollment, email opens, link clicks, status changes, unsubscribes, bounces, complaints, and magic link clicks. Use activity history to answer practical questions: - Did this person submit the expected form? - Was the tag needed for a broadcast or automation applied? - Did they enter or leave a sequence? - Did they click the magic link that was expected to update their preferences? - Did they stop receiving email because they unsubscribed, bounced, complained, or were blocked? Mailrith also provides API details for teams that need to connect outside systems. This is useful 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 it exists helps you route integration tasks to the right person. ## 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 manual row-by-row work. This guide explains how to prepare clean CSV files, map fields, monitor background jobs, and avoid accidental broad changes. - [Custom Fields](https://mailrith.com/docs/custom-fields.md): Custom fields are the shared data schema for your workspace — define them once and they become available across subscriber records, forms, segmentation rules, automation conditions, and email merge variables. - [Tags](https://mailrith.com/docs/tags.md): Tags are the fastest way to categorize subscribers — apply them through imports, forms, automations, and magic links, then use them as targeting filters across every send surface in Mailrith.