Runs in Timeline

Sprints are a common tool in the development process. Runs allow you to model your sprints by allowing to set up recurring milestones of a certain length in weeks.

Set up Runs

First ensure Runs are enabled via the Organization Settings > Features section. (They are enabled by default though.)

Open the Timeline tab in the header or press Shift + 3 on your keyboard.

Look for the ➕ icon at the top right. A Calendar Opens which includes a Set up Runs in the header.

"Set up Runs" button

Set up a Run Configuration

Run Config Menu

  • Short Name: Up to 5 letters. Helpful to differntiate runs in case there exist parallel Run Configurations.
  • Color: The color in which the Runs are shown throughout the app.
  • Project-specific: If left unchecked the generated Runs will be global ones, that can contain cards from any proejct. If you make it project-specific, it will only be shown on the timeline if the associated project is currently visible as well. This mechanism can also be used to hide certain Runs from team members that don’t have access to the respective project.
  • Run duration: How many weeks a Run is active
  • Run start day: What day of week to start a new run. If the start day coincides with the current week day, the Run starts on the current day, else it starts in the next fitting day within future.
  • Number of upcoming Runs to create: This number also includes the currently active run. Once a Run has been finished, a new one is automatically created.
  • Finish Behaviour: Here you can configure which cards should be automatically moved to the next run once a Run is finished. The execution happens at about 03:00 CEST.

All settings can be changed later on. Updating the Run duration will only impact the currently running or future Runs. Updating the start day will only impact future runs and prolong (or shorten the current one).

Run Description, Statistics & User Capacity

Once a Run is opened, you can click on the i button below the Add Card button on the left. This will show you the description box as well as statistics about the run including a burndown chart. The description area allows you to update the description and upload a cover image. This image will also be used for the run’s tooltip.

The shown velocity is accumulating done cards from the full Run Configuration.

Stats of a Run

This view also includes Capacity Tracking. It shows how work is distributed across your team mates. You can set the individual capacity of each team member to see who might be overbooked or out of work. Look for the ⚙️ icon at the top right to set and modify the capacity for each user.

If a user is overbooked, the line chart will show striped overlay. If a member still has capacity left, it will be represented with dots. Users are sorted by the percentage of work done (based on work assigned, not capacity).

The Run header also shows your personal capacity vs work load at a quick glance.

Capacity Tracking Widget

Deleting Runs

You cannot directly delete a Run Configuration. You can delete Runs that are active or in the future. Deleting a Run sets an implicit stop date for that Run Configuration beyond which no new Run is started even if you change e.g. the Run duration. You can remove the Stop date to resume the run by opening the Run Configuration via the cog icon ⚙️ on an opened Run.

Adding Cards to a Run

There are various ways to do so:

  • Open the card properties by clicking the properties button on the top right side of an opened card, you can find the Run picker below the priority and effort properties. Click the “Pick” button to select either upcoming or past Runs.
  • Select multiple cards and use the bulk action milestone button to add multiple cards to the same Run.
  • Order your cards by Run to drag cards between different Run lanes.
  • Click on the Run icon on any card to open the Quick Settings.

There can only be one Run assigned to a card. To distribute a task over multiple Runs you can consider using hero cards.

Working with Runs

Run Icons

Cards with a Run will show a small circular-ish arrow icon. Hover over the icon to see more information about the current state of the Run.

Cards with a past Run will show an empty Icon. The current one will be filled whereas future ones are also filled but show a dashed outline.

Pinned Runs

The header area of the Card inspector includes a pin icon 📌. Pinning a Run allow you to quickly access this Run from your hand. This allows you to move cards between a Run and your hand without having to leave the hand view. Opening the Timeline tab will also always open the pinned Run (or Milestone). You can only have a single element pinned at the same time. I.e. either a Milestone or a Run.