Skip to main content
You can create custom bookmarks within your incident channels, to give snapshot information and easy-to-find links.
  1. To create a custom bookmark, first navigate to Settings → Slack Channel.
The Slack Channel settings page for configuring bookmarks
  1. Click the ”+ Add New button”, and create. You will have three options for the kind of bookmark you’d like to add:
Bookmark type picker showing pre-defined property, pre-defined link, and custom link options “Pre-defined property” is a field that contains useful information about the incident (i.e. the status of the severity), and will update as it is changed. “Pre-defined link” lets you choose from our pre-defined bookmarks which link you to a page related to the incident (i.e. a Jira issue ticket). “Custom link” gives you the ability to bookmark to a link. This can be useful if you have documentation that is commonly accessed during an incident.
  1. You can also choose under what condition a bookmark appears (i.e. a link to a critical incident doc only appears on critical incidents).
Configuring conditions for when a bookmark appears, such as severity level
  1. Next click “Create”, and your bookmarks will appear at the top of the incident channel when the conditions you selected are met.
Bookmarks displayed at the top of an incident channel in Slack Bookmarks are a great way to give at-a-glance information to team members when they join an incident.
The Slack API limits what we’re able to do with the bookmarks in your incident channel. Currently, we’re only able to append bookmarks to the end of the list. This might mean that sometimes, you see bookmarks end up in a different order than the one you’ve set up.The alternative is to individually remove and re-add all of the bookmarks we’ve created. This turned out to be visually much more jarring, and it also resulted in the reordering of any bookmarks that had been manually added to the channel. Although having bookmarks out of order isn’t ideal, we feel like this is the best option for now.Some actions, such as creating a call for your incident, happen in the background after we’ve created your incident channel. In these cases, you’re likely to see the “Join the call” button show up at the end of your list of bookmarks. We’ve got much more control over announcement messages: you’ll see that the order here will always be what you expect.We always keep an eye out for improvements to the Slack API, and we hope to be able to improve this in the future.