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
labels parameterTells the agent which tagged content to search. You can use tag names.
| Format | Syntax | Logic |
|---|---|---|
| Simple list | labels="A,B,C" | OR - returns any content that has at least one of these tags |
| Array | labels='[["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
labels_exclusive parameterControls whether content with no tags are included in results.
| Value | Outcome |
|---|---|
true | Only content matching your tags |
false (default) | Content matching your tags, plus any sources with no tag |
Limits
| Limit | Value |
|---|---|
| Max groups (array format) | 20 |
| Max tags per group | 50 |
| Max tags total | 500 |
Edge cases
| Scenario | Behavior |
|---|---|
| Invalid tag | Ignored - 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
Updated 19 days ago
Did this page help you?
