Page tree


Agile Cards come with the scanner - a feature allowing the team members to easily synchronise the physical and digital boards. In order for the scanner to work the physical board must represent the status columns of the digital board in VisualStudio Team Services / TFS.

Your physical board does not need to show all the columns featured on your digital board.

In many cases the physical board can be a simplified, more down-to-earth version of the digital board. The scanner algorithm will deal with such a situation without any problems.

The scanner needs to know which of the columns you want to be displayed on your physical board. The columns will be represented by the human-readable labels, and divided by computer-readable "splitters". 

In order to start setting up the physical board for scanning, click on the "camera" icon in the top right of your digital boards:

You will be presented with the scanner dialog. It has two tabs. One for setting up the splitters and one for performing the actual scan.

Make sure to go to the "Board layout" tab first. It is here where you will be able to set up your physical board. The screen will allow you to add the columns and reorder them on your physical board. To add a new column, select it from the drop-down list. To reorder the columns simply drag them along the screen into the new position. In order to remove the column from the physical board, press the "X" icon.

All the configuration which is performed on this screen only affects the physical board setup for Agile Cards. It is safe to experiment freely!

Printing splitters

When you are ready with the configuration, press the "Print splitters" button. Agile Cards will generate a document which will contain the necessary information for the scanner to work. The document will consist of three sections, usually divided into three pages:

  • board QR code
  • human-readable column labels
  • computer-readable column splitters

Here is what you need to do with them:

Board QR Code

The QR code for the board makes it easier to access the Agile Cards scanner from mobile devices.

You can cut out the QR code and attach it to your board in whatever place. You can also chose to not use the board QR code at all. It is optional and not required by the Scanner to operate.

Human-readable column labels

Human -readable column labels are as simple as that. You can print them out, cut them into separate strips and attach the labels to the top of your columns. Or the bottom. Or wherever it makes sense for your team to have them. As in case of the Board QR code, the human-readable column labels are not required for the Agile Cards scanner to work.

Computer-readable column splitters

Column splitters are required for Agile Cards scanner to properly recognize the placement of the cards on the physical board. Once printed make sure you cut them into separate strips along the cutting lines. When attaching the splitters to the board always make sure that:

  • the KR codes are not obscured by anything (pins, tape, magnets)
  • the splitters are positioned vertically with "top" and "bottom" labels positioned correctly
  • The order of the column is not changed, so that the neighbouring columns' labels printed out on the splitters match accordingly

Place all the physical components on the physical board and... that is it! You are done setting up your physical board for the scanner to work.


You have set up your physical board. Now you can print cards to put them on your physical board or use Agile Cards board scanner to update your digital boards easily.

If you have any comments or feedback related to our product please do not hesitate to contact us at Spartez Support Portal or

  • No labels

This page has no comments.