Change Detection

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
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.

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