> For the complete documentation index, see [llms.txt](https://docs.devhub.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devhub.com/trace-technology/configuration-options.md).

# Configuration options

Each Trace is configured with the following options

| Option                                                              | Required                  |
| ------------------------------------------------------------------- | ------------------------- |
| [url](/trace-technology/configuration-options.md#url)               | yes                       |
| [xpath](/trace-technology/configuration-options.md#xpath)           | yes                       |
| [action](/trace-technology/configuration-options.md#action)         | no (default is "replace") |
| [noconflict](/trace-technology/configuration-options.md#noconflict) | no (default is "true")    |

## URL

This is the full URL on the original site that we will be using to Trace (i.e. `https://example.com/some-subpage/`)

## xpath

This is the targeting for which element within the page we will be using to Trace

### Common examples

Target a div with `id="block-main"`

```
//div[@id="block-main"]
```

Target a span with `class="body body-main"`

```
//span[@class="body body-main"]
```

Target the second div with a `class="wrapper"`

```
(//div[@class="wrapper"])[2]
```

*Note: xpath selectors are exact, so for cases where you are targeting an* `id` *or* `class`*, the selector needs to match what appears in the source code (i.e. ordering of the classes is important).*

For information on how complex xpaths can be formed, you can visit the xpath with lxml documentation here: <https://lxml.de/xpathxslt.html>

## action

This option configures how we will manipulate the HTML of the page

| Option            | Description                                                                              |
| ----------------- | ---------------------------------------------------------------------------------------- |
| replace (default) | This will replace the content of the matched element with our page content               |
| after             | This will append a new div after the matched element which will contain the page content |

## noconflict

There is two modes for how the content of the page is added

| Option         | Description                                                                                                                                                                                                                                                                                                                       |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| true (default) | When noconflict is enabled, we add the content to the page using an auto-sizing iframe element. This option is good for cases where you don't know if there will be style conflicts with your page content and their original site. This option is not recommended for SEO strategies as the content of the page is not indexable |
| false          | When noconflict is disabled, we add the rendered HTML and style tags directly into the page                                                                                                                                                                                                                                       |