> For the complete documentation index, see [llms.txt](https://docs.ixkio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ixkio.com/features/subtags.md). # Subtags ## Overview Subtags allow you dynamically add [Meta Data](/features/meta-data.md) ***into*** the responses. This is handled by using curly brackets {}. For example, you could add a CUID (customer unique ID) stored in the ixkio platform dynamically onto a URL by including {CUID} within your redirect response. So, if your CUID for Tag Code was `12345`, a URL entered as : ``` https://seritag.com?code={CUID} ``` would become : ``` https://seritag.com?code=12345 ``` ## Using Subtags Subtags can generally be used anywhere you enter data. For example, you can include a Subtag into a URL Redirect, or a Tag Name, or even another Extended Data field ! At the point that ixkio presents that data, it will automatically substitute the content of the Subtag. You can find which subtags can be used in which locations by reading the documents related to the element you are editing. However, example subtags include :

Subtag	Data Substituted
{xuid}	The Tag Code XUID
{cuid}	The CUID for that Tag Code
{uid}	The UID for that Tag Code
{scount}	The ixkio scan count
{ccount}	The chip scan count (if enabled)
{folder}	The Folder name
{batch}	The Batch name
{taggroup}	The Tag Group name
{tagname}	The Tag name
{cluster}	Cluster name
{countrycode}	Two letter country code of the scan location
{dtcreated}	Date and time the Tag Code was created
{dtassigned}	Date and time Tag Code was Assigned
{assignstatus}	Assignment status : 1 or 0
{encodestatus}	Encoded status : 1 or 0
{timezone}	Abbreviated timezone (PST, GMT, WET, etc)
{currency}	Three letter currency code (GBP, USD, EUR, etc)
{tzlocal}	Local date and time (based on IP, not device)
{randnum}	Random number
{browser}	Device browser (mobile devices only)
{method}	Scan method (nfc,qr) (if using QR URL)
{randhex}	Random hexadecimal
{os}	Device OS (ios, android, other)

## Subtags For Redirects Subtags can be added directly to your Redirect URL (both the Default Response and any RuleGroup Responses). For example, if you wanted to add the scan count into your redirect URL, you would enter : ``` https://seritag.com/somepage?scancount={scount} ``` would become : ``` https://seritag.com/somepage?scancount=12345 ``` (Seritag.com is just being used as an example domain) You can also use it directly into the URL. So, for example you could use a subtag to dynamically add a Custom ID (CUID) into a URL to change the page name. For example, assuming your CUID for a tag was 'beach' : ``` https://seritag.com/{cuid}-property ``` would become : ``` https://seritag.com/beach-property ``` ### Subtags in Extended Data If you do not want to put Subtags into the Ruleset Responses or want data to be separated into other fields, it is possible to include Subtags within Extended Data fields. For a step by step on how to do this, read the [Subtags in Extended Data](/flex-api/subtags-in-api-extended-data.md) documents. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.ixkio.com/features/subtags.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.