Fork me on GitHub

Items

Adding

There are two ways to add an item to a column. Either click the plus button (which will always be at the right, below any items) or right-click in the column and use the context menu.

However you choose to add an item, you will get an Add Item modal dialog that has the Column dropdown defaulted to the one you acted from.

When adding an item, the only requirement is that it have a Title.

The Description text can be entered as Markdown for better readability and detail. This allows for lists, formatting, code display, tables, and much more.

The Assigned To dropdown lets you choose a user to have the item assigned to them. The Category dropdown will only be visible if categories were added to the board, and allows for clearer visibility of item types.

You can change the column the item will be created in (in case you changed your mind) from the Column dropdown.

The Color input displays a colorpicker that stores the colors you've used in your browser for future use. It also allows manual entry of colors.

The Date Due input displays a standard datepicker, which should be familiar to most users.

And finally, the Points input is meant to be used to provide an estimate for the level of work required for the item.

Column Position

Items are initially displayed on the board in the order they were added to a column. However, you can re-order items by dragging and dropping them into a new position. You can also drag and drop to move an item into a new column (this will also set its position within the new column).

The activity history for an item does not show position changes. However, column changes are recorded.

Column View

When viewing items in columns, each item has three main sections that provide useful details at a glance.

In the header is the item's name and points are displayed in a badge on the far right (if there are any points).

Below the header is the item's description. This area does allow you to view the full description, however the maximum height of an item is limited so there will be scrolling involved for more than about a dozen lines.

The bottom section of an item displays the assignee on the left (or "Unassigned") with item details on the right. If there are comments, a speech bubble icon () is seen. If there are attachments, a paperclip icon () will show. Hovering the mouse over either icon will give you a count of the comments or attachments.

If a due date has been assigned, it is displayed on the far right. And if there are categories, the assigned category (or "Uncategorized") is at the bottom right.

Context Menu

Items in a column have a right-click context menu. For standard users, this menu has options for View Item, Edit Item and Add New Item.

For admin users, there is an additional Delete Item option. Deleting an item cannot be undone, so take care when using this feature. You will be asked to confirm deletion.

The Edit Item option opens a dialog much like the Add Item dialog. However, it is filled with the information from the item you right-clicked for editing.

The View Item option opens the item Detail View.

Detail View

To get a larger view of an item, as well as see its complete history, simply double-click the item or right-click and choose View Item from the context menu.

All activity on an item is displayed in a slide-out menu on the left. You can collapse this by clicking the icon.

The main dialog has the item Title and Points (if Points were entered) in the header. The first section is colored to match the chosen item color and contains the complete description, followed by one row with the assignee, category (if the board has categories), and current column for the item.

Beneath the item details are one or two buttons depending on the user level. The Edit button will open the item in an Edit Item dialog (much like the Add Item dialog). For admin users, there is also a Delete Item button. Deleting an item cannot be undone, so take care when using this feature. You will be asked to confirm deletion.

The next section displays any attachments associated with the item, followed by an input to allow uploading of an attachment.

The final section displays any comments on the item, and an input for adding a comment to the item.

When there are attachments (see second screenshot), they may be viewed or directly downloaded using the icons on the right of each attachment ( and , respectively). For admin users and the original submitter, there is also a delete icon ().

For comments, there is only a delete icon () following the same rules as for attachments (admin or creator). Comments are also sortable by oldest or newest using the dropdown.