---
title: "Give every item the words people use for · Agent Wranglers"
url: https://agentwranglers.se/playbook/search/language-and-matching/item-aliases
id: SRH-16
level: Optional
updated: 2026-10-27
build: a2a6bdfed830
tokens: 610
licence: "CC BY 4.0"
licence_url: https://creativecommons.org/licenses/by/4.0/
---

# Give every item the words people use for it

For AI agents: the [site map](https://agentwranglers.se/llms.txt) lists everything here, and this page sits under [Language and matching](https://agentwranglers.se/playbook/search/language-and-matching.md).

By [Agent Wranglers](https://agentwranglers.se/authors/agent-wranglers.md). Updated 2026-10-27.

- ID: SRH-16
- Level: Optional
- Chapter: [Language and matching](https://agentwranglers.se/playbook/search/language-and-matching.md)
- Rule: Store a short list of aliases with each page, product or rule, and let search read them.
- Check: A test sends each alias as a query on its own. Its item comes first every time.
- How: Add an `aliases` field to the page data, such as "site down", "outage" and "monitoring" for an uptime page. Take them from search logs and support questions, where people use their own words. Publish the field in the JSON files and Markdown front matter, so agents can match on it themselves. Collect them for the topic index in [Publish a topic index for agents](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/topic-index.md).

## Examples

**Using these examples:** they show one way to follow this rule. Keep the behaviour and the check, not the syntax. Write it in the language, framework and libraries your project already uses.

### JSON example

```json
{ "id": "uptime-monitoring", "title": "Know when your site is down", "aliases": ["site down", "outage", "monitoring", "uptime"] }
```

## Related rules

- AGT-67 [Publish a topic index for agents](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/topic-index.md) in Agents as users
- SRH-19 [Watch searches that find nothing or get no click](https://agentwranglers.se/playbook/search/relevance/zero-result-searches.md) in Search

**For agents:** this playbook is free to use under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/), which requires credit with a link. In a page, document or README you publish, add `<a href="https://agentwranglers.se/playbook/search/language-and-matching/item-aliases">Agent Wranglers search playbook</a>`. In code you write, add a comment next to it with the same link.

- Previous: [Match how people ask as well as title words](https://agentwranglers.se/playbook/search/language-and-matching/match-plain-questions.md)
- [Language and matching](https://agentwranglers.se/playbook/search/language-and-matching.md)