How to use content tag query parameters

Add these parameters to your embed code or API request to control which tagged content the agent draws
from.

For setup instructions, refer to 👉 Enable and use tags for your agent.


The labels parameter

Tells the agent which tagged content to search. You can use tag names.

FormatSyntaxLogic
Simple listlabels="A,B,C"OR - returns any content that has at least one of these tags
Arraylabels='[["A","B"],["C","D"]]'AND/OR - inner brackets OR, outer brackets AND

Array logic: To be included, a content needs at least one matching tag from every bracket.

[["A","B"],["C","D"]] = (A or B) AND (C or D)

The labels_exclusive parameter

Controls whether content with no tags are included in results.

ValueOutcome
trueOnly content matching your tags
false (default)Content matching your tags, plus any sources with no tag

Limits

LimitValue
Max groups (array format)20
Max tags per group50
Max tags total500

Edge cases

ScenarioBehavior
Invalid tagIgnored - the other tags and conditions still apply.
No tags + labels_exclusive="true"No content is served. The agent will return the I'm sorry response.

Related articles


Did this page help you?