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("Subscription Segments", withAttributes: nil)
[[PushNotificationManager pushManager] postEvent:@“Subscription Segments” withAttributes:@{}];
PushwooshInApp.getInstance().postEvent("Subscription Segments");
Pushwoosh.push((api) => {
api.postEvent('Subscription Segments', {});
// Make sure to enable In-Apps in your Pushwoosh WebSDK init params
applicationCode: 'XXXXX-XXXXX',
inApps: {
enable: true

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

To enable Subscription Segments for a particular app, go to Subscription Segments section of the app menu and set the toggle on the top right to ON.

Then, 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, you can define whether they will subscribed to a topic automatically or not. To subscribe users who have already opted-in to receive push notifications from you, check the Existing users checkbox for a topic.

  • When the Existing users checkbox is set to Subscribed, 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 few hours, depending on how large your current userbase is. When done, the status is switched to processed.

  • When the checkbox is set to Not subscribed, 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

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. To update the audience size manually, refresh the page.

Each topic has its own code needed to send messages to that topic's subscribers via API.

Click Publish to save changes and continue setting up Subscription Segments with customizing the Rich Media.

Please note that the subscription prompt won't be shown to users until you press Apply on the bottom of the page.

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.

Click Apply to save changes and publish the Rich Media.

Please note that the subscription prompt won't be shown to users until you press Apply on the bottom of the page.


  • 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

Control Panel

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.


To send a topic-based push notification to a particular segment, add the "subscription_segments" parameter to your /createMessage request. The "subscription_segments" param is an array of segment codes. You can find a segment code below the topic name in the Subscription Segments section of Control Panel.

"request": {
"application": "XXXXX-XXXXX",
"auth": "kVbUA.....OUtzcMa0XN",
"notifications": [{
"send_date": "now",
"content": "Hello world!",
"subscription_segments": ["4E0D0-C2AAF"]