DocsGrow your audience

Subscribers

Statuses, custom fields, tags, filters and segments, bulk actions, CSV imports, double opt-in and export.

Each newsletter has its own list, kept apart from your other newsletters. Only people with the status subscribed are ever sent campaigns.

Statuses

Subscriber statuses
StatusMeaning
pendingSigned up but hasn't clicked the confirmation link yet (double opt-in).
subscribedReceives campaigns and the welcome series.
unsubscribedLeft the list. Honoured immediately, including one-click unsubscribes from the inbox.
bouncedHard bounced. Suppressed permanently.
complainedMarked an email as spam. Suppressed permanently.
suppressedAdded to the suppression list by hand.

Imports, signup forms and the API never move a bounced, complained or suppressed address back to subscribed. An owner can resubscribe someone by hand, with a written reason.

Custom fields

Store anything you want to personalise with, such as company, plan or city, and use it in emails as a merge field. Keys are lowercase letters, digits and underscores, start with a letter and are up to 40 characters long.

Every subscriber also records where they came from (signup form, embed, import, API or added by hand), the page and UTM tags of their signup, their time zone once known, and when they last opened or clicked.

Tags

Tags are free-form labels such as vip or beta-2026, stored in lowercase. Add them by hand, in bulk to a segment, on import, from the API, or automatically when someone finishes your welcome series. A subscriber can have up to 50.

Filters

The Subscribers page has a filter builder for finding exactly the readers you mean. Add conditions, then choose whether to show subscribers matching all of them or any one of them.

Filter conditions
ConditionOptions
Statusis any of, or is none of, the statuses above
Emailcontains, doesn't contain, ends with domain (such as acme.com), or is exactly
Namecontains, is empty, is set
Tagshas any of, has all of, or has none of the tags you list
Sourcesigned up through a form, an embedded form, an import, the API, or was added by hand
Signup datebefore, or on or after, a date; in the last N days; more than N days ago
Engagementopened in the last N days, clicked in the last N days, never opened, or inactive for N days
Emails receivedat least, or at most, N emails
Custom fielda field is, contains, is empty or is set
Time zoneis, is in region (such as Europe), or is unknown
Welcome seriesin progress, completed, stopped, or never started
Campaignreceived it, didn't receive it, opened it, received it but didn't open it, or clicked in it

Engagement only counts a person's opens and clicks: Apple Mail's automatic opens and security scanners never make someone look engaged. “Opened in the last N days” also matches readers who clicked, since a click means they opened it. “Inactive for N days” means no open or click in that time, and on the list at least that long, the same rule as list maintenance.

Segments

Save a filter as a segment to send a campaign to it. A segment is worked out at the moment the campaign starts sending, so it is always current, and only subscribed readers are ever sent to.

  • Segments can use the conditions that read the subscriber alone: status, email, name, tags, source, signup date, opened in the last N days, never opened, inactive for, custom fields and time zone.
  • Conditions that look at other activity (clicked in the last N days, emails received, welcome series and campaign) work in the filter builder but can't be saved in a segment. Tag those readers with a bulk action instead, and segment on the tag.
  • Every newsletter comes with a built-in Inactive 180 days segment.

Bulk actions

Select readers by hand (up to 1,000) or select everyone matching the filter, then choose an action. Large selections run in the background in small batches, with live progress; you can keep working, or cancel a run part-way.

Bulk actions
ActionWhat it does
Add tags / Remove tagsUp to 20 tags at a time.
Set custom field / Clear custom fieldSets one custom field to the same value for everyone, or removes it.
SubscribeMarks readers as subscribed. You give a reason of at least 10 characters (why they may receive email), kept in the audit log. Bounced, complained and suppressed addresses are never resubscribed, and only an owner can resubscribe someone who unsubscribed.
UnsubscribeUnsubscribes readers, with an optional note kept with the suppression entry and in the audit log.
Resend confirmationSends a fresh confirmation email to readers still awaiting confirmation, at most once a day each. Needs a connected sending provider.
Add to welcome seriesStarts the welcome series for subscribed readers who haven't had it yet.
Export CSVA CSV of the selection. The download link works for an hour.
Delete permanentlyOwners only. Erases the readers' records; suppression entries are kept so they are never mailed by mistake.
  • Every action is safe to repeat: readers it doesn't apply to are skipped and counted, and the run reports how many were changed and skipped, and why.
  • Confirmation and welcome emails from a bulk run go out at a steady pace rather than all at once. A bulk subscribe stops if the account reaches its subscriber limit (ask us for more room).
  • A newsletter can have up to three runs going at once. Every status change is written to the audit log.

Importing a CSV

  1. Upload
    Go to Subscribers → Import and choose a CSV with a header row: up to 10 MB and 100,000 rows.
  2. Map columns
    Pick the email column (required) and optionally name, tags and any custom fields. Common headers like “Email”, “Name” and “Tags” are matched for you. Tags in one cell can be separated by commas, semicolons or pipes.
  3. Confirm consent
    Confirm that everyone on the list opted in, and say where they came from. This is recorded with the import.
  4. Review the result
    You see how many were added, updated and skipped, and can download the rows that failed with the reason for each.
  • Existing subscribers are updated: tags and fields are merged, and a name in the file replaces the old one.
  • Duplicate rows in the file are skipped. Addresses on your suppression list are imported as suppressed.
  • If the account reaches its subscriber limit, the import stops adding people and reports how many were skipped, so you can import them again once there is room.
  • You can add a tag to everyone in the import, and choose whether they enter the welcome series.

Double opt-in

On by default for new newsletters, and changed by an owner in Settings → General. New sign-ups get a confirmation email and stay pending until they click it.

  • Confirmation links last 7 days. Signing up again sends a fresh one, at most every 10 minutes.
  • The link opens a page with a confirm button rather than confirming on the click, so security scanners that open links can't confirm on someone's behalf.
  • List maintenance can delete sign-ups that never confirm.

Export

Download your list as a CSV at any time from the Subscribers page; owners and editors can both export. The file includes email, name, status, tags (separated by ;), source, signup, confirmation, unsubscribe and last-engaged dates, and one column per custom field.

Removing someone completely

An owner can erase a subscriber, which deletes their record. If they were suppressed, the suppression entry is kept so they are never mailed again by mistake.

newsletter.sh

Newsletters on your own sending account. Invite-only, sent through Amazon SES or the provider you already use.

© 2026 newsletter.sh