Change Detection

Try our Chrome extension

Easily add the current web-page from your browser directly into your changedetection.io tool, more great features coming soon!

Changedetection.io needs your support!

You can help us by supporting changedetection.io on these platforms;

The more popular changedetection.io is, the more time we can dedicate to adding amazing features!

Many thanks :)

changedetection.io team

General
Filters & Triggers
Restock & Price Detection
Notifications

Title

CSS/JSONPath/JQ/XPath Filters

One rule per line, any rules that matches will be used.

CSS - Limit text to this CSS rule, only text matching this CSS rule is included.
JSON - Limit text to this JSON rule, using either JSONPath or jq (if installed).
- JSONPath: Prefix with json:, use json:$ to force re-formatting if required, test your JSONPath here.
- jq support not installed
XPath - Limit text to this XPath rule, simply start with a forward-slash. To specify XPath to be used explicitly or the XPath rule starts with an XPath function: Prefix with xpath:
- Example: //*[contains(@class, 'sametext')] or xpath:count(//*[contains(@class, 'sametext')]), test your XPath here
- Example: Get all titles from an RSS feed //title/text()
- To use XPath1.0: Prefix with xpath1:

Please be sure that you thoroughly understand how to write CSS, JSONPath, XPath rules before filing an issue on GitHub! here for more CSS selector help.

Remove elements

Remove HTML element(s) by CSS selector before text conversion.
Add multiple elements or CSS selectors per line to ignore multiple parts of the HTML.

Activate for individual watches in this tag/group?

Used for watches in "Restock & Price detection" mode

Re-stock detection

In Stock only (Out Of Stock -> In Stock only)
Any availability changes
Off, don't follow availability/restock

Follow price changes

Changes in price should trigger a notification

Below price to trigger notification

Minimum amount, Trigger a change/notification when the price drops below this value.

Above price to trigger notification

Maximum amount, Trigger a change/notification when the price rises above this value.

Threshold in % for price changes since the original price

Price must change more than this % to trigger a change since the first check.
For example, If the product is $1,000 USD originally, 2% would mean it has to change more than $20 since the first check.

Notifications Muted / Off

Use system defaults

Notification URL List

Use AppRise URLs for notification to just about any service! Please read the notification services wiki here for important configuration notes.
discord:// (or https://discord.com/api/webhooks...)) only supports a maximum 2,000 characters of notification text, including the title.
tgram:// bots can't send messages to other bots, so you should specify chat ID of non-bot user.
tgram:// only supports very limited HTML and can fail when extra tags are sent, read more here (or use plaintext/markdown format)
gets://, posts://, puts://, deletes:// for direct API calls (or omit the "s" for non-SSL ie get://) more help here
Accepts the {{token}} placeholders listed below

Send test notification Notification debug logs

Notification Title

Title for all notifications

Notification Body

Body for all notifications ‐ You can use Jinja2 templating in the notification title, body and URL, and tokens from below.

Show token/placeholders

Token	Description
`{{base_url}}`	The URL of the changedetection.io instance you are running.
`{{watch_url}}`	The URL being watched.
`{{watch_uuid}}`	The UUID of the watch.
`{{watch_title}}`	The title of the watch.
`{{watch_tag}}`	The watch label / tag
`{{preview_url}}`	The URL of the preview page generated by changedetection.io.
`{{diff_url}}`	The URL of the diff output for the watch.
`{{diff}}`	The diff output - only changes, additions, and removals
`{{diff_added}}`	The diff output - only changes and additions
`{{diff_removed}}`	The diff output - only changes and removals
`{{diff_full}}`	The diff output - full difference output
`{{diff_patch}}`	The diff output - patch in unified format
`{{current_snapshot}}`	The current snapshot text contents value, useful when combined with JSON or CSS filters
`{{triggered_text}}`	Text that tripped the trigger from filters

Warning: Contents of {{diff}}, {{diff_removed}}, and {{diff_added}} depend on how the difference algorithm perceives the change.
For example, an addition or removal could be perceived as a change in some cases. More Here

For JSON payloads, use |tojson without quotes for automatic escaping, for example - { "name": {{ watch_title|tojson }} }

URL encoding, use |urlencode, for example - gets://hook-website.com/test.php?title={{ watch_title|urlencode }}

Notification format

Format for all notifications