> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatref.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Display Rules

> Control which pages of your site show the chat widget, using simple URL patterns.

Display rules decide **where** your chat widget appears. By default the widget
shows on every page. With display rules you can limit it to certain pages – or
hide it on others – by matching the page's URL. You set them up under
**Settings → Display Rules**.

## How display rules work

* A master **on / off** switch turns rules on for the whole agent.
* You can add up to **10** rules.
* Each rule has a **type** and a **pattern**:

| Type            | What it matches                                | Example                                            |
| --------------- | ---------------------------------------------- | -------------------------------------------------- |
| **Contains**    | Any URL that includes the text you type.       | `/pricing` matches `/pricing` and `/pricing/teams` |
| **Exact match** | Only the URL that matches the pattern exactly. | `/support` matches `/support` and nothing else     |

When rules are on, the widget shows only on pages that match a rule.

## Set up display rules

<Steps>
  <Step title="Open Display Rules">
    Go to your agent's dashboard and open **Settings → Display Rules**.
  </Step>

  <Step title="Turn rules on">
    Flip the master switch to turn display rules on for this agent.
  </Step>

  <Step title="Add a rule">
    Add a rule, choose its **type** – **Contains** or **Exact match** – and type
    the **pattern**, e.g. `/support`.
  </Step>

  <Step title="Add more (optional)">
    Repeat for each page or section, up to 10 rules.
  </Step>
</Steps>

For example, a travel agency that only wants the widget on its help page would
turn rules on and add one **Exact match** rule for `/support`.

<Note>
  Display rules also decide **which agent** appears on which page when you run more
  than one bot from a single embed code. See
  [Multi-Agent Routing](/deploy/multi-agent-routing) to set that up.
</Note>

## Next steps

<CardGroup cols={2}>
  <Card title="Multi-Agent Routing" icon="route" href="/deploy/multi-agent-routing">
    Show different bots on different pages from one embed code.
  </Card>

  <Card title="Widget Appearance" icon="paint-roller" href="/widget/appearance">
    Set colors, icon, position, and branding for the widget.
  </Card>
</CardGroup>