Set up the email subscription preference center

Email subscription preference center overview

The email subscription preference center lets subscribers choose which types of emails they want to receive, such as newsletters, promotions, or product updates.

Instead of unsubscribing from all emails, users can opt out of specific categories and stay subscribed to what matters most to them. This improves the overall user experience, reduces full opt-outs, and helps you keep a healthier and more engaged audience.

Why you should set it up

Setting up a subscription preference center improves both user experience and legal compliance.

Improve user experience

Letting users choose which types of emails they want to receive, such as newsletters, promotions, or product updates, helps reduce full opt-outs and keeps your audience more engaged.

Ensure compliance with email regulations

Several laws require that users can easily manage their communication preferences:

• GDPR (EU): Requires clear options to opt in or out of specific types of communication.

• CAN-SPAM (U.S.): Requires every commercial email to include a visible unsubscribe link.

If you don’t provide these options:

• You may face legal penalties for non-compliance

• Your email service provider (ESP) account may be flagged or suspended

How email categories and message delivery work

Important

Email categories configured in the subscription preference center apply only to new campaigns created after the feature is enabled. Campaigns created before category setup will be sent without regard to user preferences and will not respect category-based opt-ins.

When you set up the preference center and add categories, Pushwoosh automatically creates internal user tags for each category. These tags store each user’s preferences and are used to determine who receives which emails. Example tags include:

• email_pref_newsletter

• email_pref_promotional

• email_pref_product_updates

Only users with a true value for a category tag (e.g., email_pref_newsletter = true) will receive emails from that category. Users who have not opted into the category will be excluded automatically.

Once the preference center is set up for your project, when you send a campaign (via Journey or One‑Time Message), you will be prompted to assign a category before sending. Learn more

This ensures that all emails are properly categorized and only sent to users who have opted in to receive that type of content.

Email categories also help you organize your email content and filter your campaign audiences.

Handling transactional messages

Transactional messages are a separate message type designed for critical, non-promotional communication. Unlike marketing emails, transactional messages bypass all delivery restrictions to ensure they reach the user.

When creating an email campaign in Pushwoosh, you must choose between two message types: marketing and transactional. Learn more

Set up the subscription preference center

To enable category-based filtering and let users manage preferences, follow these steps to configure the preference center in your project:

1. Go to Settings > Configure platforms. Locate Email channel configuration, click Edit, then find Subscription preference center.

Note

If this section isn’t visible, ensure your email channel is fully configured with verified domains and default sender details. The preference center appears only after the email platform is active.

2. Click Set up categories in the Subscription preference center to define which email categories users can subscribe to (e.g., Promotional, Newsletter, Product Updates, Events).

Tip

You can define up to 20 categories per project.

3. In the modal, enter clear and user‑friendly category names and click Apply to save.

Category naming

• Use names your recipients will understand and avoid internal or technical jargon.
• Each category name must be unique.

Once saved, users will see these categories when they open the preference center.

Manage categories

Once the preference center is enabled, its settings will appear directly below the email configuration section. Here, you can view and manage your subscription categories, see how many users are subscribed to each one, and add or edit categories as needed.

Add a category

To add a category to your Subscription preference center:

1. Click Add category.
2. Enter a clear, unique category name and click Apply.

Rename a category

To rename a category, click the pencil icon next to its name.

Once the category is renamed, the associated internal tag will be automatically updated to match the new category name.

Delete a category

To delete a category, open the three‑dot menu next to it and select Delete category.

What happens when you delete a category

• The category is permanently removed from the Subscription preference center.
• Users who opted out of that category will no longer see it in their preferences.
• Any active campaigns or journeys using the category will be paused automatically. You’ll receive a notification in the Notification Center informing you about the issue. To resume sending, reassign a new category in any affected campaigns.

Disable the preference center

To disable the preference center:

1. Click the three-dot menu in the top right of the Subscription preference center section.

2. Select Disable preference center.

3. In the confirmation dialog, click Disable.

What happens when you disable the preference center

• Subscribers will no longer see category options in the preference center.
• The unsubscribe page will still be available, so users can continue to opt out completely.
• Emails will continue to be sent as usual, but without category-based filtering, until you re-enable the preference center.

From the same three-dot menu, select Copy Preference center link to copy the URL.

How to let users unsubscribe from a category or manage preferences

Default behavior: Unsubscribe from a category

By default, when a user clicks the Unsubscribe link you included in an email, they are unsubscribed only from the category assigned to that specific email (e.g., Newsletter).
A confirmation screen appears, stating they will no longer receive emails from that category.

Here, users can also click:

• Resubscribe to opt back into that category.

• Manage preferences to adjust their full email preferences.

This is the default unsubscribe behavior and works automatically. No additional setup is required when adding an unsubscribe link to your emails.

Optional setup: Full preference center

You can insert a link to the Preference center in your emails (for example, in the footer or a call-to-action button) so users can manage their communication preferences. To do so:

• In the drag-and-drop email editor, select Manage preferences link from the Action type dropdown. Learn more

• In the HTML code editor, use the variable %%PW_EMAIL_PREFERENCE_CENTER_LINK%%. Learn more

When users click the Preference center link, they will see a page showing all available email categories. Here they can:

• Select which types of emails they want to receive.

• Unsubscribe from multiple categories at once.

• Click Unsubscribe from all to opt out of all marketing emails at once.

Note

If a user unsubscribes from all marketing emails, the following tag is automatically applied: Unsubscribed Emails = true

This tag ensures a complete opt-out from all marketing email categories.

Frequently asked questions

What happens if I rename a category?

When you rename a category, the associated internal tag is automatically updated to match the new category name.

What happens to existing campaigns when I set up the subscription preference center?

Email categories only apply to new campaigns and templates created after the feature is enabled. Campaigns created before category setup will be sent without regard to user preferences and will bypass opt-outs (like transactional messages).

Will users still receive transactional emails if they unsubscribe from all categories?

Yes. Transactional messages bypass user preferences, unsubscribe settings, and frequency capping to ensure critical communication, such as password resets or order confirmations, is always delivered.

What happens to campaigns if I delete a category used in them?

Any active campaigns or journeys that use the deleted category will be paused automatically. You’ll receive a notification in the Notification Center informing you about the issue. To resume sending, you must assign a new category to the affected campaigns or journeys.

Can I create custom category names?

Yes. You can create up to 20 unique categories per project. Use clear, user-friendly names that match the type of content users expect to receive (e.g., Newsletters, Product Updates).

Do I need to do anything to enable unsubscribe links?

Add an unsubscribe link using the drag-and-drop editor or HTML code editor to your email content so recipients can opt out. The default behavior is described in Default behavior: Unsubscribe from a category. Optionally, add a Preference center link so users can manage all categories in one place.