---
title: 'Liquid objects: user_agent'
description: >-
  The user-agent, which is the name of the crawler, for a specific group in the
  [`robots.txt` file](/themes/architecture/templates/robots-txt-liquid).
api_name: liquid
source_url:
  html: 'https://shopify.dev/docs/api/liquid/objects/user_agent'
  md: 'https://shopify.dev/docs/api/liquid/objects/user_agent.md'
---

# user\_​agent

The user-agent, which is the name of the crawler, for a specific group in the [`robots.txt` file](https://shopify.dev/themes/architecture/templates/robots-txt-liquid).

The `user_agent` object consists of a `User-agent` directive, and a value of the name of the user-agent. For example:

```
User-agent: *
```

***

Tip

You can [customize the `robots.txt` file](https://shopify.dev/themes/seo/robots-txt) with the [`robots.txt.liquid` template](https://shopify.dev/themes/architecture/templates/robots-txt-liquid).

***

## Properties

* * directive

    [string](https://shopify.dev/docs/api/liquid/basics#string)

  * Returns `User-agent`.

  * value

    [string](https://shopify.dev/docs/api/liquid/basics#string)

  * The name of the user-agent.

```json
{
  "directive": "User-agent",
  "value": "*"
}
```

##### Example

```
{
  "directive": "User-agent",
  "value": "*"
}
```