Subscription Segments

How to segment your audience and send perfectly relevant messages with a couple of clicks

To enable Subscription Segments for your account, please apply to your Customer Success manager or Customer Support team.


Subscription Segments give you a simple way to manage the types of push notifications your users subscribe to and target your campaigns to relevant user segments.

Use Subscription Segments to:

  • increase user activations: users who have options when subscribing are more likely to opt-in. Users are free to decide which message categories they'd like to receive from you, meaning that these messages are relevant to, expected by, and valuable for the users.

  • grow CTR: users are interested in receiving and opening messages they've subscribed to, skyrocketing your campaigns' CTR.

  • manage user subscriptions: users can change their subscription preferences at any time, and you can update the subscription topics if needed.

How it works

Subscription Segments are segments of users who opted-in to receive from you messages of a particular topic. That's how it works:

  1. You set a list of topics and publish the subscription prompt with that list. Basically, it's a customizable Rich Media webpage containing topic names and checkboxes for subscribing to each topic.

  2. Users, when seeing the subscription prompt, can select the topics they are most interested in.

  3. When sending a push campaign, you can select the topic your message belongs to — the message will be sent to only those users who have subscribed to that topic.

Topics selected by a user are saved as that user's Subscription Segment tag values.

How to implement


For a website, integrate the latest Pushwoosh Web SDK using this guide. For mobile, integrate Pushwoosh SDK:

  • for iOS v5.19.2 and above,

  • for Android v5.19.2 and above.


The subscription prompt is the Rich Media page displayed to your web users as a custom pop-up window, and for mobile users — as an In-App Message. To display this subscription prompt to users, call the postEvent API method to send the Subscription Segments event to Pushwoosh.

PWInAppManager.shared().postEvent("SubscriptionSegments", withAttributes: nil)
[[PushNotificationManager pushManager] postEvent:@“SubscriptionSegments” withAttributes:@{}];

For websites, a subscription prompt is displayed on click on the Custom Subscription Popup.

Subscription Segments event is created by default for all accounts with Subscription Segments enabled.

When deciding on when to display the prompt, take into account the user flow on your website or in your app. For example, you can add the My Subscriptions button to the app user profile, so that the user clicking that button will see the list of topics to subscribe.

Creating Subscription Segments

First, set a list of topics you are going to offer your users.

The topics' names are displayed to users when they decide on their subscription, so make sure these names are descriptive and give a clear understanding of what kind of content each category contains.

For existing users, the default state of a topic defines whether a user will be subscribed to that topic automatically or not.

  • When the default topic state is set to ON, Pushwoosh will start subscribing your existing users to that topic in the background, which is indicated with the pending status next to a topic name. This process may take up to a few hours, depending on how large your current userbase is. When done, the status is switched to processed.

  • When the default topic state is set to OFF, existing users won't be subscribed to that topic.

Users who are subscribed already will see the subscription prompt with topics in their actual statuses. That means, even if a user opted-in to receive your notifications and, therefore, is subscribed by Pushwoosh to topics enabled by default, this process may be not completed at the moment, so the pending topics will appear disabled for that user.

For new users, the subscription prompt will appear with all topics checked by default.

Subscription prompt for new users

Click Publish to save changes and start displaying the channels list to users when they opt-in.

The number of users in a particular Subscription Segment is displayed in the Audience column near the topic name. These numbers are updated automatically once a day.

Customizing subscription prompt

Next, modify the appearance and content of your subscription prompt.

Provide understandable and explicit texts in Header, Sub-header, and Unsubscribe text fields to tell your users what they can subscribe to.

Editing texts

Adjust colors of texts, controls, and background to fit your website or app style.

Customizing Rich Media appearance

Click Save to save changes and publish the updated Rich Media.


  • If you delete a topic, its tag value is removed from the Subscription Segment tag.

  • If you delete a topic, you cannot create a new one with the same name unless you publish the updated prompt.

  • If you already have active subscribers in your app, they will be subscribed to the topics for which you set the default state to ON. They can change their subscription preferences at any time after that.

  • If you add a topic to the existing list and set its default state to ON, Pushwoosh will start subscribing your existing users to that topic in the background. They can opt-out when see the updated prompt.

  • In terms of subscriptions to topics, there are three possible states for a user — they can be subscribed to a topic, not subscribed to a topic, or unsubscribed from it.

  • You can edit topic names, and subscribed users will remain subscribed.

If a user unchecks all topics or some of them in the subscription prompt and submits changes, they are still subscribed to your app's notifications in general. That means they cannot be targeted as Subscription Segments; however, you can reach out to them with broadcast messages or pushes targeted based on Tags and Filters.

Sending messages

To target a push notification to users subscribed to a particular Subscription Segment, go to Send Push section of Control Panel and open the Segmentation tab.

Toggle Subscription Segments ON, then select the topic the message belongs to.

If you select both Subscription Segment and Filter, the message will be sent to users who belong to that Subscription Segment and that Filter simultaneously.