Configuration options

Each Trace is configured with the following options

Option

Required

url

yes

xpath

yes

action

no (default is "replace")

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