Tags FAQ
Get answers to all of your data tag questions
How many tags can I set?
Check your plan limits, for the number of data tags that can be set per user. You are only limited on the number of data tags that can be set on each user. There is no limit to the total amount of data tag combinations that can exist within an app.
For example, free plans can have 2 tags per user, but you can still have an unlimited amount of keys and values that can be used. If User A has tags: first_name : Jon and vip_status : gold, User B can have tags: favorite_color : red and dogs_favorite_color : brown. In this case, User A cannot have another tag like favorite_color : green until the first_name or vip_status tag is removed or your plan is upgraded.
If you need more data tags, contact our sales team to discuss more options.
Where can I check how many tags my users have?
Navigate to Audience > Users page “Tags” column or see Exporting User Data.
How do I know if I’m using more tags than my current plan allows?
You can export the specific users over the plan limit within the dashboard Audience > Users > Export. Details in Bulk Updating User Attributes or Data Tags.
How do I reduce the number of data tags my app is using?
There are several options including API updates to uploading a CSV. See Tags for a list of all options.
What happens to my data tags if am over the plan entitlement?
Your application will continue to have the data tags set per user. When adding or updating tags, you won’t be able to make changes to users over your plan limits. This means if a user is at or over their tag limit, you will first need to delete the unwanted tags, then make another request to add or update the desired tags.
For example, if your account tag limit is 20 custom tags per user, then each user can only have 20 unique tag “keys” set at once. See example conditions below:
- Any request to set 1-20 tag keys, will succeed.
- Any request to set 21+ tag keys, will fail, no tags will be set.
- Any request to set 1-20 tag keys, will succeed.
- Any request to set 21+ tag keys, will fail, no tags will be set.
- A request to set 1 new tag key will succeed.
- A request to set 2+ new tag keys will fail, no new tags will be set.
- A request to update 1-19 of the currently set tag values and set 1 new tag will succeed.
- A request to update 1-19 of the currently set tag values and set 2+ new tag will fail. You need to make 2 requests. 1st to delete the unwanted tag keys, 2nd to set the new tag keys.
Why are data tags not showing on my device?
There are a few reasons why tags may not be set listed below.
Offline or unstable network connection
The most common reason for tags not showing on a device is due to unstable or no network connection where the request to update the tags does not make it to OneSignal.
Android mobile SDKs will cache data tags and will retry adding the tag upon detecting a stable internet connection.
iOS mobile SDKs provides a callback for you to handle this case.
Web SDK, the user must be subscribed before the tag is added to the device record. Once the user registers, the tags will automatically be sent to our server as long as the page session is the same (the user has not navigated to another page).
End of page session
Web SDK - If the person leaves the page before the tags are set, they will not get the tags.
Clearing browser cache
When web subscribers clear their browser data/cookies/cache it destroys the push records for al sites that the user is subscribed under. OneSignal provides a feature to automatically resubscribe the user upon returning to the site with our SDK, but this will not add the tags back unless some additional steps are taken. See What happens when I clear browser cookies? for more details.
Tags FAQ
Get answers to all of your data tag questions
How many tags can I set?
Check your plan limits, for the number of data tags that can be set per user. You are only limited on the number of data tags that can be set on each user. There is no limit to the total amount of data tag combinations that can exist within an app.
For example, free plans can have 2 tags per user, but you can still have an unlimited amount of keys and values that can be used. If User A has tags: first_name : Jon and vip_status : gold, User B can have tags: favorite_color : red and dogs_favorite_color : brown. In this case, User A cannot have another tag like favorite_color : green until the first_name or vip_status tag is removed or your plan is upgraded.
If you need more data tags, contact our sales team to discuss more options.
Where can I check how many tags my users have?
Navigate to Audience > Users page “Tags” column or see Exporting User Data.
How do I know if I’m using more tags than my current plan allows?
You can export the specific users over the plan limit within the dashboard Audience > Users > Export. Details in Bulk Updating User Attributes or Data Tags.
How do I reduce the number of data tags my app is using?
There are several options including API updates to uploading a CSV. See Tags for a list of all options.
What happens to my data tags if am over the plan entitlement?
Your application will continue to have the data tags set per user. When adding or updating tags, you won’t be able to make changes to users over your plan limits. This means if a user is at or over their tag limit, you will first need to delete the unwanted tags, then make another request to add or update the desired tags.
For example, if your account tag limit is 20 custom tags per user, then each user can only have 20 unique tag “keys” set at once. See example conditions below:
- Any request to set 1-20 tag keys, will succeed.
- Any request to set 21+ tag keys, will fail, no tags will be set.
- Any request to set 1-20 tag keys, will succeed.
- Any request to set 21+ tag keys, will fail, no tags will be set.
- A request to set 1 new tag key will succeed.
- A request to set 2+ new tag keys will fail, no new tags will be set.
- A request to update 1-19 of the currently set tag values and set 1 new tag will succeed.
- A request to update 1-19 of the currently set tag values and set 2+ new tag will fail. You need to make 2 requests. 1st to delete the unwanted tag keys, 2nd to set the new tag keys.
Why are data tags not showing on my device?
There are a few reasons why tags may not be set listed below.
Offline or unstable network connection
The most common reason for tags not showing on a device is due to unstable or no network connection where the request to update the tags does not make it to OneSignal.
Android mobile SDKs will cache data tags and will retry adding the tag upon detecting a stable internet connection.
iOS mobile SDKs provides a callback for you to handle this case.
Web SDK, the user must be subscribed before the tag is added to the device record. Once the user registers, the tags will automatically be sent to our server as long as the page session is the same (the user has not navigated to another page).
End of page session
Web SDK - If the person leaves the page before the tags are set, they will not get the tags.
Clearing browser cache
When web subscribers clear their browser data/cookies/cache it destroys the push records for al sites that the user is subscribed under. OneSignal provides a feature to automatically resubscribe the user upon returning to the site with our SDK, but this will not add the tags back unless some additional steps are taken. See What happens when I clear browser cookies? for more details.