Set Onesignal Tags
Last updated
Was this helpful?
Last updated
Was this helpful?
The "Set OneSignal Tags" block allows you to customize the status bar on native devices by passing customer tag information from your Shopify store to the OneSignal notification service. This enables personalized notifications and experiences based on customer attributes.
Navigate to Online Store > Themes in your Shopify admin panel
Click Customize next to your current theme
Select the App Embeds section
Enable the Set OneSignal Tags block
Click Save to apply the changes
To add tags to a customer profile:
Go to Customers in your Shopify admin
Select the customer you want to tag
In the customer details page, locate the Tags section (indicated by an arrow in the right sidebar)
Click the edit icon (pencil) next to the Tags
Enter your tags using the format key:value
(e.g., premium:true
, subscription:monthly
)
Press Enter after each tag
Click outside the tag field to save
Tags should follow this format to be recognized by the system:
For example:
premium:true
subscription:monthly
preference:casual
Create customer segments based on:
Subscription type
Purchase history
Customer preferences
Loyalty tier
Customize notifications based on customer attributes:
Send different notifications to premium vs. standard customers
Adjust notification frequency based on customer preferences
Target notifications based on product interests
Tag Naming Convention
Use consistent, lowercase naming for tags
Avoid spaces or special characters
Example: customer_type:premium
instead of Customer Type:Premium
Limit Tag Volume
Only create tags that will be used for targeting
Keep tag values concise
Avoid excessive tagging that could slow performance
Test Before Deployment
Verify tag transmission using the OneSignal dashboard
Test notifications on different device types
Confirm status bar customizations appear as expected
Privacy Considerations
Only use non-sensitive customer information
Ensure compliance with privacy regulations
Provide clear opt-out mechanisms for notifications
Verify the customer is logged in
Check that tags follow the key:value
format
Inspect the browser console for JavaScript errors
Confirm the WebToNative library is loading correctly