# Subscriber Imports, Exports, and Bulk Actions > 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. - Human page: https://mailrith.com/docs/subscriber-imports-exports - Markdown page: https://mailrith.com/docs/subscriber-imports-exports.md - Category: Subscriber Management - Reading time: 13 min read - Last updated: 2026-06-13 - Related keywords: Subscriber Imports, Exports, and Bulk Actions, Subscriber Imports, Exports, and Bulk Actions documentation, Subscriber Management, Subscriber Management documentation, Mailrith documentation, Mailrith help, Before Importing, Map CSV Columns, Background Import Jobs, Export Subscribers, Bulk Actions, Import Troubleshooting, Subscribers, 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 Prepare CSV files, map columns, run background import jobs, export filtered subscribers, and apply safe bulk actions. ## Sections - Before Importing - Map CSV Columns - Background Import Jobs - Export Subscribers - Bulk Actions - Import Troubleshooting ## Visual Reference ![Mailrith subscribers page showing subscriber list and actions.](https://mailrith.com/docs/screenshots/subscribers.png) The Subscribers page is where imports, exports, filters, and bulk actions come together. ## Before Importing Subscribers Prepare your CSV file before you upload it to Mailrith. Decide what each CSV column contains, which tags Mailrith should add to the imported subscriber records, and whether Mailrith should add those subscribers to a sequence. 1. Open the spreadsheet or exported file before you go to Mailrith. 2. Make sure the first row has clear column headers, such as Email, Name, Company, Plan, Signup Source, or Interest. 3. Remove any CSV rows that do not include an email address. 4. When the same email address appears in more than one CSV row, choose the row with the correct subscriber information or merge the needed information into one row. After the correct row is ready, remove the extra duplicate rows. 5. If your CSV file includes subscriber information such as plan, region, role, or renewal date, create the needed [Custom Fields](https://mailrith.com/docs/custom-fields.md) in Mailrith before you start the CSV import. 6. Create or choose the [Tags](https://mailrith.com/docs/tags.md) that Mailrith should add to these subscribers, such as "Imported - April Launch List". 7. Remove anyone who has not agreed to receive your emails. A CSV import adds subscribers to the workspace, so the file should include only people you are allowed to contact. 8. Save the file as a CSV, and keep a copy of the original file until you confirm that the imported subscriber records contain the expected information. - **Email is required.** Each imported CSV row needs an email address. Mailrith cannot create subscriber records from rows without a valid email address. - **Names are optional.** You can add subscribers with only an email address and add names later. - **Create custom fields first.** Create any needed custom fields before you start the CSV import so you can map CSV columns to those fields. - **Blank custom field cells do not erase saved values.** When a CSV row updates an existing Subscriber, a blank mapped custom field cell leaves that Subscriber's saved value unchanged. New Subscribers still need values for required custom fields. - **Separate multi-select choices with commas.** For a Multi Select custom field, write choices such as "News, Product" in one CSV cell. Each choice must match one of the field's saved options. - **Tags are useful for import history.** Add a tag such as "Imported - April Launch List" so you can find and use those imported subscribers later. - **Choose sequences carefully.** If you add imported subscribers to a sequence during the CSV import, they can start receiving sequence emails when the sequence rules allow sending. ## Map CSV Columns The import wizard asks you to match each CSV column to a Mailrith field. These mappings tell Mailrith where to save the imported subscriber data from each column. For example, match a CSV column named "Email Address" to the subscriber email field, and match a CSV column named "Plan" to a custom field named Plan. 1. Click **Subscribers** in the left sidebar to open the Subscribers page for the workspace where you want to add or update subscribers. 2. Check the workspace name in the left sidebar. If the workspace name is not correct, open the workspace switcher and choose the correct workspace before you upload the CSV file. 3. Click **Create Subscriber** in the page header. 4. In the **Create Subscribers** drawer, click **CSV Import**. 5. In the **CSV Import** drawer, use the **Upload CSV** field to choose the CSV file you prepared. 6. After Mailrith reads the CSV file, check that the row count matches the number of CSV rows you expected and that the **Map CSV Columns** table shows the columns from your file. 7. Find the row for your email address column. In that row, open the **Mailrith Field** dropdown and choose **Email**. Mailrith requires this mapping before it can create or update subscriber records. 8. If your CSV file has a name column, open the **Mailrith Field** dropdown for that column and choose **Name**. 9. Match useful subscriber information columns to the right [Custom Fields](https://mailrith.com/docs/custom-fields.md). If a needed custom field does not exist yet, close the drawer, create the custom field, and start the CSV import again. 10. Leave any column set to **Do not map** when you do not want Mailrith to save the information from that CSV column. 11. Under **Add Tags to Subscribers**, choose the [Tags](https://mailrith.com/docs/tags.md) you want Mailrith to add to every imported subscriber. 12. If you need a new source tag for this CSV import, enter the new tag name in **Create New Tag**. 13. If you want Mailrith to add imported subscribers to a [Sequence](https://mailrith.com/docs/sequences.md), turn on **Add subscribers to sequences** and choose the sequence. Turn on this option only after the sequence is ready and tested. 14. Check the permission confirmation box. Mailrith cannot start the import until you confirm that these Subscribers gave permission or that you have another valid lawful basis to import and contact them. 15. Click **Import**. If the button is disabled, make sure exactly one CSV column is mapped to **Email** and that the uploaded CSV file contains rows. Mailrith keeps the import button disabled until the CSV file and column mappings are ready to use. If the button is disabled, check that exactly one CSV column is mapped to the email field and that Mailrith can read the uploaded CSV file. ## Background Import Jobs Subscriber imports run in the background. Mailrith starts the import job, and you can keep using the app while Mailrith processes the CSV rows. After an import job starts, Mailrith shows a started message. The subscriber list for the active workspace does not update while the import job is still running. If an import job finishes in a different workspace, that job does not change the subscriber list you are viewing. Uploaded import CSV files are temporary. Mailrith removes the stored CSV after the import completes, fails, or expires, while keeping the import job history so your team can review what happened. Imports started through a workspace API key or OAuth app keep normal import job details, so your team can see which connected system submitted the import. 1. After clicking **Import**, wait for Mailrith to show the import started message. 2. Close the message, but stay in the same workspace while you check the imported subscriber records. 3. Wait for the import job to finish before uploading the same CSV file again. 4. Click **Subscribers** in the left sidebar again, or refresh the Subscribers page after the import job finishes. 5. Use the **Search subscribers** box to search for several known email addresses from the CSV file. Confirm that Mailrith created or updated the matching subscriber records. 6. If you added an import tag, filter by that tag and compare the visible subscriber count with the number of subscribers you expected to receive that tag. 7. Open one or two subscriber records and check that the tags, custom fields, status, sequence enrollment, and activity history match the choices you made during the CSV import. 8. If the imported subscriber records are wrong, fix the CSV file or column mappings before starting a new import job. Do not keep importing the same incorrect CSV file. If an import job cannot start, Mailrith shows an error before any subscriber records are changed. Fix the CSV file, column mappings, or workspace selection, then try again. ## Export Subscribers Subscriber exports also start from the Subscribers page. Mailrith uses the current search and filters for the export, so you can export a specific group instead of the full subscriber list. 1. Click **Subscribers** in the left sidebar to open the Subscribers page for the workspace you want to export from. 2. Use the status filter, the **Search subscribers** box, the **Tag** filter, the **Sequence** filter, or the **Subscriber Segment** filter to narrow the list to the subscribers you want to export. 3. For a tag-based export, choose **Tag** in the status filter, choose **has any of** or **has none of**, then select the tags that define the export list. 4. For a sequence-based export, choose **Sequence** in the status filter, choose the sequence relationship you need, then select the sequences that define the export list. 5. Review the visible subscriber list and visible count to confirm which subscribers the export will include. 6. Select the checkbox next to each subscriber you want to export, or use the checkbox in the table header to select the visible page. 7. If you need every subscriber that matches the current filters, use the all-matching selection option that appears after you select the current page. 8. Open the **Bulk Actions** dropdown above the table and choose **Export**. 9. Wait for Mailrith to show the export started message. Mailrith prepares the CSV file in the background, even when you selected only a few visible rows. 10. When the export is ready, open the download link from the email Mailrith sends you and confirm that the rows match the subscribers you meant to export. 11. Store or share the exported CSV file carefully because subscriber exports can include personal information. Export download links expire after seven days. Download the file from the email before the link expires if your team needs to keep a copy. Use exports when you need an offline backup, a file for another system, or a review list for a campaign. If you only need to send a Mailrith campaign, use tags and segments in Mailrith instead of exporting subscribers and importing the same subscribers again. ## Bulk Actions After Import Bulk actions let you update many subscribers from the subscriber list. You can select specific rows, select one page of subscriber records, or apply an action to all subscribers that match the current filters. 1. Click **Subscribers** in the left sidebar and apply the search, status, tag, sequence, or segment filter that defines the subscriber group. 2. Review the visible subscriber count and scan the first page of subscriber records to make sure the filters found the right group. 3. Select individual rows, the current page, or all subscribers that match the current filters. 4. Open the **Bulk Actions** dropdown and choose **Add Tag**, **Remove Tag**, **Add to Sequence**, **Remove from Sequence**, **Export**, or **Delete**. 5. If a drawer opens, choose the tag or sequence you want to add or remove. For **Add Tag**, you can also use **Create New Tag** if the tag does not exist yet. 6. Click **Apply** only after the selected subscriber count, filters, and chosen action are correct. 7. After the bulk action finishes, check a few subscriber records and their activity history to confirm that Mailrith made the expected change. - **Add tags:** add a label to the selected subscribers. - **Remove tags:** remove a label when a group no longer belongs in that category. - **Add to sequence:** add selected subscribers to an active sequence. - **Remove from sequence:** stop selected subscribers from continuing in a sequence. - **Delete subscribers:** permanently remove selected subscribers from the workspace after confirmation. Bulk actions can change a large subscriber list quickly. Before applying a bulk action to all matching subscribers, check the filters and subscriber count carefully. A typo in the search box or the wrong segment can change which subscribers receive the action. ## Import Troubleshooting - **The file will not parse:** export the spreadsheet again as a CSV file, make sure the first row has column headers, and remove any merged spreadsheet cells. - **The import button stays disabled:** confirm that one email column is mapped and that required custom field columns contain valid information. - **Subscribers did not get expected tags:** check the tag selection in the import wizard and review one Subscriber's **History** tab after the import job finishes. - **Subscribers did not enter a sequence:** confirm that the sequence is active and that you selected the sequence during the CSV import. - **Counts look different than the CSV row count:** Mailrith removes duplicates by email address, so repeated email addresses update one subscriber record instead of creating duplicate subscriber records. ## Related Guides - [Subscribers](https://mailrith.com/docs/subscribers.md): 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. - [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.