diff --git a/README.md b/README.md
index 7fdbc4ef..a1bc8e95 100644
--- a/README.md
+++ b/README.md
@@ -22,6 +22,7 @@ Live status: **🟨 Partial outage**
- Incidents reports are posted as issue comments
- Issues are locked so non-members cannot comment on them
- Issues are closed automatically when your site comes back up
+ - Slack notifications are sent on updates
- GitHub Pages are used for the status website
- A simple, beautiful, and accessible PWA is generated
- Built with Svelte and Sapper
@@ -35,14 +36,14 @@ _This section is updated automatically when the status of any site changes._
-| URL | Status | History | Response Time | Uptime |
-| --- | ------ | ------- | ------------- | ------ |
-| [Google](https://www.google.com) | 🟩 Up | [google.yml](https://github.com/koj-co/upptime/commits/master/history/google.yml) |
88ms | 
-| [Wikipedia](https://en.wikipedia.org) | 🟩 Up | [wikipedia.yml](https://github.com/koj-co/upptime/commits/master/history/wikipedia.yml) |
139ms | 
-| [Internet Archive](https://archive.org) | 🟩 Up | [internet-archive.yml](https://github.com/koj-co/upptime/commits/master/history/internet-archive.yml) |
577ms | 
-| [Hacker News](https://news.ycombinator.com) | 🟩 Up | [hacker-news.yml](https://github.com/koj-co/upptime/commits/master/history/hacker-news.yml) |
367ms | 
-| [Broken Site](https://thissitedoesnotexist.com) | 🟥 Down | [broken-site.yml](https://github.com/koj-co/upptime/commits/master/history/broken-site.yml) |
0ms | 
-| Secret Site | 🟩 Up | [secret-site.yml](https://github.com/koj-co/upptime/commits/master/history/secret-site.yml) |
42ms | 
+| URL | Status | History | Response Time | Uptime |
+| ----------------------------------------------- | ------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [Google](https://www.google.com) | 🟩 Up | [google.yml](https://github.com/koj-co/upptime/commits/master/history/google.yml) |
88ms |  |
+| [Wikipedia](https://en.wikipedia.org) | 🟩 Up | [wikipedia.yml](https://github.com/koj-co/upptime/commits/master/history/wikipedia.yml) |
139ms |  |
+| [Internet Archive](https://archive.org) | 🟩 Up | [internet-archive.yml](https://github.com/koj-co/upptime/commits/master/history/internet-archive.yml) |
577ms |  |
+| [Hacker News](https://news.ycombinator.com) | 🟩 Up | [hacker-news.yml](https://github.com/koj-co/upptime/commits/master/history/hacker-news.yml) |
367ms |  |
+| [Broken Site](https://thissitedoesnotexist.com) | 🟥 Down | [broken-site.yml](https://github.com/koj-co/upptime/commits/master/history/broken-site.yml) |
0ms |  |
+| Secret Site | 🟩 Up | [secret-site.yml](https://github.com/koj-co/upptime/commits/master/history/secret-site.yml) |
42ms |  |
@@ -89,6 +90,7 @@ Four times per day, another workflow runs and records the response time of your
- [Repository](#repository)
- [Endpoints](#endpoints)
- [User agent](#user-agent)
+- [Notifications](#notifications)
- [Assignees](#assignees)
- [Branding](#branding)
- [Intro text](#intro-text)
@@ -172,6 +174,22 @@ Requests made to the GitHub API must include a valid `User-Agent` header (see [U
user-agent: your-github-username
```
+#### Notifications
+
+You can add services to send downtime notifications to. Currently, only Slack notifications are supported.
+
+##### Slack
+
+Use `slack` as the `type` and provide a Slack channel ID as `channel` in the configuration.
+
+```yaml
+notifications:
+ - type: slack
+ channel: C016QTU9S9Y
+```
+
+A Slack App has to be registered and installed prior to usage, with the scope `chat:write` (see [chat.postMessage](https://api.slack.com/methods/chat.postMessage) docs), and the environment variable `SLACK_APP_ACCESS_TOKEN` should be set with the access token of the Slack app.
+
#### Assignees
You can add members of your team to be assigned to every downtime issue: