Quick Configuration guide

This is a Quick-Start Guide for configuring WatchTower app. Explore the comprehensive instructions below.

1. Board Creation

  1. Navigate to Apps → WatchTower → Manage Boards.

  2. Click the Create Board button located in the upper right-hand corner.

  3. Input Board Name and Description.

  4. Upon successful creation, your new board will appear in the list. Select it.

  5. Opt for the top-right ... to get access to the Board settings. Learn more.

You will encounter Configuration tabs on the left-hand side. The next step involves adding Sources.

2. Adding Sources

  1. Navigate to Tab General → click Add Source.

  2. Fill in the required data. Examine the example provided.
     For Cloud sources, you need an API token for authentication. Check how to generate API token.
     Important: We do not retain your login details. They are solely utilized to access the target source: Jira.

  3. Feel free to add as many sources as desired. To alter the hierarchy of sources, use the drag-and-drop feature. More details can be found Learn more.

3. Column Configuration

  1. Match listed 'Unmapped statuses' with the respective Columns. Only statuses holding issues need mapping. You will receive notifications whenever new issues emerge in unmapped statuses.


  2. Columns can be added, renamed, removed, and their sequence changed. Learn more.


4. Swimlane Configuration

  1. Choose between two options to base swimlanes on: 'Jira Instances' and 'JQL queries'. Learn more.

5. Board Sharing

  1.  The board you've crafted can be shared with other users or user groups, with access granted through 'View' and 'Edit' permissions. Learn more.


On this page