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

Default Notifications

These notifications apply to all web page watches, or you can configure them per group or per watch separately.

Add a notification service:

List all

Notification URL List

Configured list of notifications - Use the "Add a notification service" to add to this.

Send test notification Notification debug logs

Show advanced help and tips

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

Customise notifications

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_open_url}}`	The Open Link Override set on the watch, otherwise the same as watch_url. Use this when the watched URL is an API endpoint or RSS feed but you want to link to the real page.
`{{watch_uuid}}`	The UUID of the watch.
`{{watch_title}}`	The page title of the watch, uses <title> if not set, falls back to URL
`{{watch_tag}}`	The watch group / tag
`{{preview_url}}`	The URL of the preview page generated by changedetection.io.
`{{change_datetime}}`	Date/time of the change, accepts format=, change_datetime(format='%A'), default is '%Y-%m-%d %H:%M:%S %Z'
`{{diff_url}}`	The URL of the diff output for the watch.
`{{diff}}`	The diff output - only changes, additions, and removals All diff variants accept `lines=`, `context=`, `word_diff=`, `ignore_junk=` args, e.g. `{{diff(lines=10)}}`, `{{diff_added(lines=5, context=2)}}`
`{{diff_clean}}`	The diff output - only changes, additions, and removals — Without (added) prefix or colors
`{{diff_added}}`	The diff output - only changes and additions
`{{diff_added_clean}}`	The diff output - only changes and additions — Without (added) prefix or colors
`{{diff_removed}}`	The diff output - only changes and removals
`{{diff_removed_clean}}`	The diff output - only changes and removals — Without (added) prefix or colors
`{{diff_full}}`	The diff output - full difference output
`{{diff_full_clean}}`	The diff output - full difference output — Without (added) prefix or colors
`{{diff_patch}}`	The diff output - patch in unified format
`{{diff_changed_from}}`	Only the changed words/values from the previous version — e.g. the old price. Best when a single value changes per line; multiple changed fragments are joined by newline.
`{{diff_changed_to}}`	Only the changed words/values from the new version — e.g. the new price. Best when a single value changes per line; multiple changed fragments are joined by newline.
`{{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 }}
Regular-expression replace, use |regex_replace, for example - {{ "hello world 123" | regex_replace('[0-9]+', 'no-more-numbers') }}
For a complete reference of all Jinja2 built-in filters, users can refer to the https://jinja.palletsprojects.com/en/3.1.x/templates/#builtin-filters

Notification format

Format for all notifications

Discord does not render HTML — switch to Plain Text format to avoid   and other HTML entities appearing literally in your notifications.

Notification base URL override

Base URL used for the {{ base_url }} token in notification links.
Default value is the system environment variable 'BASE_URL' - read more here.

Back to settings