Shopify App Overview

Overview of OneSignal Shopify App Features.


Major Release: User-Centric Update Q1 2023

OneSignal is in the process of migrating from a device-centric model (player ID) to a new user-centric data model. To learn more, check out the User Model Beta Overview.

Version 9 of our documentation, which is device-centric, is now outdated. Version 11 of our documentation is the current version with user-centric updates.

This guide walks through all OneSignal Shopify App features and setup.


Setup OneSignal Shopify App

If you have not done so, visit Shopify App Setup to get started!

Permission Prompt

Your site visitors must give you permission to send them push notifications. This happens through a prompt which you can customize to ask them to subscribe to your messages.

You can always edit within your OneSignal Shopify App settings.


Set your Icon!

The icon image you set here for the icon field is used in some of the Automated Messages that don't include products.

A square 256x256 pixels icon is recommended for best fit across all browsers.

You can customize the message, your own icon, and the delay for when to show the prompt:

  • pageviews controls how many pages or refreshes the user must perform to be prompted.
  • seconds controls how long the user has to be on the page before the prompt shows.

Welcome Message Setup

Welcome notifications are an optional way to thank users after subscribing to your site. Users will see a welcome notification as soon as they subscribe.

Can be edited within Messages > Automation > Welcome New Subscribers screen.

Note: The image you select for the Icon field is shared with the Permission Prompt from Step 1.


Abandoned Cart Recovery Setup

Abandoned Cart notifications are a way to bring shoppers back to your site if they leave after reaching the Shipping step in the checkout process. If you click Skip at this step, the Abandoned Cart notifications will not be enabled.


Testing Abandoned Cart Notifications

If the Abandoned Cart notifications are set to be active, simply add an item from your Shopify store to your cart

Abandon the checkout process either by navigating to another page or closing the cart's browser tab.

You should receive an abandoned cart notification within approximately 60 minutes from the time you navigated away from the cart.

Changing Abandoned Cart Message

We generally don't recommend customizing this message since it includes a lot of information to help remind the user about the last item added to the cart. If you would like to customize the message and ok with adding some liquid syntax see the FAQ - Customizing Abandoned Cart Notifications.

In-Stock Alerts

A big challenge in e-commerce is to bring visitors back to your website in order to convert these interested shoppers into buyers. But what if the product they are looking for on your website is sold out?

OneSignal’s in-stock automation allows your site visitors to get notified as soon as an item they were looking for is back in stock. Shoppers are asked for push notification permissions when they visit a product page that has zero inventory.


When they opt-in, they receive back-in-stock alerts prompting the shoppers to complete the purchase before the product is sold out again. These alerts will have a link to the product page and the product image added automatically, without any configuration.


Testing In-Stock Alerts

As the Shopify store admin:

  • Activate in-stock alerts automation on OneSignal
  • Change the inventory Quantity Available for any product SKU to 0 (SKU must be set)
  • Uncheck "Continue selling when out of stock" if checked

As a shopper:

  • Open another browser.
  • Navigate to the product SKU that you set out-of-stock earlier on your store.
  • Subscribe to the in-stock permission prompt.

As the Shopify store admin, change the inventory count for the product SKU to anything greater than 0, indicating the product is back in stock. You should receive the in-stock alert on the browser you subscribed to as a shopper.

Send Shipping Updates

Shopper satisfaction is very critical in generating repeat business. Keep your customers informed and happy by sending “Shipping Notifications” for their orders. We will automatically send notifications when items in an order are partially or completely fulfilled.

Product Image and Shipment tracking URL (if available, otherwise order status page) will be automatically added to the shipping notification.

Shipping notifications are sent to shoppers who have opted-in to receiving push notifications on your store and have ordered items.


Testing Shipping Notifications

Log in as a shopper:

  • You must have subscribed to notifications from OneSignal in step #4
  • Place a test order
  • Navigate to another page or close the browser tab from which you have placed the test order

Log in as an admin:

  • Activate Shipping Update notifications on OneSignal
  • Fulfill the test order partially or completely on Shopify
  • Test shopper should receive the shipping update with the tracking url (if available)

Sending Notifications

Through the OneSignal-Shopify App Dashboard, you can send any message you want, anytime you need! Messages are also saved so you can duplicate and edit them to re-use for any purpose. Common examples we will demonstrate below include:

  • Sending Discounts
  • Ask Users to follow you on Social Media
  • Cross Promotions with other sites

Within Messages > Campaigns select New Campaign

Add the Campaign Name which will help identify the message to reuse again later. For example:

  • 10% Discount Engaged Users
  • Follow Us on Twitter over 1 week new
  • Cross-Promote Brand X


Next, we select our Audience which is the Segments of subscriptions eligible to receive the message. This defaults to All Subscriptions, but you can Send to Particular Segment(s) to add more or different segments.

For "Discount Example", the default segment "Engaged Subscriptions" contains subscribers that have been back to the site in 1 week and have been on the site 5 times or more, these are subscribers that are very active on the site and can be rewarded with a discount.


For "Follow Us on Twitter over 1 week new" campaign, we are going to create a message we can send once a month or every 3 weeks. After a week of subscribing, uses will be in this segment for 2 more weeks, then leave. This gives us the opportunity to reach out every couple weeks to new subscriptions.

  • Click Add Segment > Create Segment.
  • Name this segment First Session 7-21 days
  • Set "First Session" to greater than 168 hours
  • Click Add filter
  • Set "First Session" to less than 504 hours
  • Click Create Segment

Segment with User Tag

With the User Tag filter, you can segment subscriptions with the "Tags" OneSignal adds when actions are made. A couple examples:

made_purchase - set to true to target subscriptions that have made a purchase at some time in the past.

item_count - how many items in their cart currently. You can set "greater than" or "less than" to target subscribers with x number of items in their carts.


Example for subscribers that "made a purchase".



You can add a the following customizations to your message. Browsers do not support custom font, italics, bold, or other text decorations.

TitleTop Bold part of the message. Multiple Languages & Emojis Supported. Just copy-paste the desired emoji into the message.
MessageThe main text of your message. Multiple Languages & Emojis Supported. Just copy-paste the desired emoji into the message.
IconUpload or use a direct URL to the image. Defaults to your "Permission Prompt" icon from step 2 if not set
LinkThe URL you want the subscription to visit when clicking the push notification. Can be any URL, does not need to be your site.

For a "Social Media Example" copy-paste the URL to your social media account into the link, for instance:

For a "Discount Example", head over to your Discounts tab to create your discount. After saving your discount, you will see the "Promote" button with option to "Get a shareable link".


Copy-Paste the provided URL into the "Link" field and your message may look something like this.



You can schedule the message up to 30 days in advance and choose to send the message immediately to each v or at a specific time in the subscription's own local timezone.

For example, if you set "Send immediately" and "Deliver per subscriber's timezone" at 7:15 pm, each subscription will get it the next time it is 7:15 pm in their timezone. If that time is passed, they will get it the next day.



Campaign Created!

Click Review & Send to send the message or Save as Draft to come back to it later to send.

Frequently Asked Questions