Skip to main content
Version: 2.0.0

Subscribers

Navigate to yStore → Marketing → Subscribers.

The subscribers list shows every customer and guest who has opted into your store's newsletter or communication list. From here you can monitor list health, search for specific records, export contacts, and manage individual subscriber status. For configuration (double opt-in, guest subscriptions), see Subscription Settings.


List columns

ColumnDescription
EmailSubscriber's email address
Statusactive, pending, or unsubscribed
CustomerLinked customer account, if one exists with the same email
SourceHow they subscribed
Date subscribedWhen the record was first created

Subscriber status lifecycle

StatusMeaning
pendingSubmitted but not yet confirmed via opt-in email
activeConfirmed — eligible to receive communications
unsubscribedOpted out — record is retained for audit, but no emails are sent

Subscription sources

SourceDescription
CheckoutCustomer checked the newsletter opt-in box during checkout
Storefront formSubmitted a standalone newsletter signup form
Flow actionAdded programmatically by a Subscribe to Newsletter flow action
ManualAdmin created or imported the record directly

Managing subscribers

Searching and filtering

Use the search bar to find subscribers by email. Filter by status to focus on:

  • pending — confirm delivery issues or clean up stale records
  • active — export for campaigns
  • unsubscribed — audit opt-outs or analyze churn patterns

Manually updating status

Click any subscriber to open the detail view. From there you can:

  • Change the status manually (e.g., move pendingactive after verifying ownership)
  • View the subscription source and date
  • See the linked customer account, if any

Exporting the list

Click Export on the subscribers list to download a CSV of all (or filtered) subscribers with their status, source, and linked customer ID.


Using subscribers in flows

The Newsletter Subscribed trigger fires when a subscriber's status first becomes active — whether via confirmation click (double opt-in) or direct signup (single opt-in).

Common flows built on this trigger:

Flow goalSetup
Welcome emailTrigger: Newsletter Subscribed → Send Email: "Welcome + 10% off"
First-purchase couponTrigger: Newsletter Subscribed → Create Coupon → Send Email with code
Group assignmentTrigger: Newsletter Subscribed → Change User Group to "Newsletter subscribers"
Double welcome sequenceTrigger: Newsletter Subscribed → Send Email → Wait 3 days → Condition: no order → Send Email: "Use your discount"

See Flow Manager for setup instructions.


Double opt-in

When double opt-in is enabled at yStore → Settings → Sales → Marketing, new subscribers go through this flow:

  1. Customer submits email.
  2. Status is set to pending.
  3. Confirmation email is sent automatically with a unique link.
  4. Customer clicks the link — status changes to active.
  5. The Newsletter Subscribed flow trigger fires.

If the customer never confirms, the record stays pending indefinitely. Clean up stale pending records by filtering the list and deleting records older than your grace period (e.g., 30 days).

Pending subscribers stuck?

A high count of pending records that never confirm usually means the confirmation email is landing in spam. Check your mail delivery logs and verify your SPF/DKIM/DMARC configuration. Also ensure the confirmation email does not use a no-reply address with no MX record.


GDPR considerations

Subscriber records serve as proof of consent. The source, status, and date subscribed fields together document:

  • What the customer agreed to
  • When they agreed
  • Via which channel

For stricter compliance requirements, the GDPR plugin adds explicit consent log entries per subscriber. See the GDPR plugin documentation for full details.

Unsubscribed records are kept intentionally

yStore does not delete unsubscribed records. The unsubscribed status is retained so you can prove the subscriber opted out and that you are honoring the opt-out. Deleting the record would remove that audit trail.