A board shows tickets as cards in one column per workflow state. The Main board covers every ticket you may see; a project board covers one project. Both use the same filters as the Tickets list, and both let you change a ticket's state by moving its card. You can also choose which columns a board shows and save the result as a board of your own, listed in the Boards section of the sidebar.
Before you start
No special permission is needed to look at a board or to save one. Moving a card is a state change and follows the rules in Change a ticket's state; assigning from a card follows Update a ticket. Client users see the Boards section in the sidebar only when they are attached to at least one project. Saved boards are personal: nobody else sees yours, and you cannot see anyone else's.
Steps
- Open Main board under Boards in the sidebar (shortcut g b) for the workspace-wide board, or open a project and select Board in its header for the project board (Board · Acme support).
- Narrow the board with the filters above it: Kind (one kind, or Not
to leave one kind out), Assignee, Viewer, Priority, Label, Billing client (workspace users only), Due, and Sub-tickets (Hide sub-tickets keeps top-level tickets only; Sub-tickets of ACME-200 appears once you have chosen a parent from a card). The Main board also has Project. - Choose the columns with Columns (5 of 5) next to the filters: untick a state to hide its column. At least one column stays.
- Select a card's title to open the ticket, or use the card's menu (Actions for ACME-184) for Open ticket, Move to… (a list of every other state, including states this board does not show), and Assign to… (Unassigned or a workspace user).
- Select New ticket in the header to start a ticket; on a project board the project is preselected.
Saved boards
A saved board is a name for a set of columns and filters. It is yours alone and appears under Boards in the sidebar, after Main board, in the order you saved them.
- Set up the columns and filters you want on the Main board or a project board.
- Select Save as board…, type a name (1–60 characters), pick an Icon if you want one, and select Save. The new board opens, and its entry appears in the sidebar with that icon.
- On a saved board, change filters or columns as you like; the change lasts until you leave the board. A line under the filters reminds you of this. Select Save changes to make the current filters and columns the board's new definition.
- Board actions in the header offers Rename…, which changes the name and the icon, and Delete board. Deleting a board never touches tickets.
A board saved with every column follows the workflow: a state added later gets a column on it. A board saved with some columns keeps that set; a state archived later simply drops out. You can keep up to 20 saved boards per workspace.
Board icons
A saved board can carry one icon from a fixed set of 20, shown next to its name in the sidebar and in the page header. The set is the same for boards and projects: briefcase, building, factory, truck, anchor, hard hat, heart pulse, graduation cap, landmark, scale, server, shopping cart, lightning, shield, wrench, headset, rocket, flag, warning triangle, and light bulb. No icon keeps the ordinary board glyph. The icon is decoration for finding a board faster; it changes nothing about what the board shows. Main board has no icon of its own, and a project board shows the project's icon.
Typical boards: a Prioritise board with the Backlog and To do columns and Kind = Not Support; a Support queue board with Kind = Support and Assignee = Unassigned.
Download as Excel
Download as Excel in the header saves the board as an .xlsx workbook. The Board sheet has one column per state shown, in workflow order, with that column's cards listed downwards in board order as "ACME-184 Title"; the Tickets sheet has one row per card with every field (id, title, kind, state, open or closed, priority, project, billing client, assignee, reporter, created by, creator email, labels, start date, due date, estimate in minutes, comment count, created, updated). The download takes the filters, the columns, and the closed-column window of the board as it is on screen, but walks every column to its end rather than stopping at the cards shown. Column headings are in your interface language. A workbook holds at most 5 000 cards; a longer board is cut there. Ten downloads per minute per person.
Moving around the board
On a desktop screen the board fills the window below the top bar. The page header, the filters, and every column's header stay in place; only the cards inside a column scroll, so you always see which column you are in, and the horizontal scrollbar sits at the bottom of the window rather than under the tallest column. With a mouse, press on empty space (a column's background or the gap between columns) and drag sideways to pan the board; the scrollbar and a horizontal wheel or trackpad gesture do the same. Pressing on a card never pans, so its text stays selectable and a long press still drags the card. On a phone the whole page scrolls as usual.
Drag and drop
With the mouse or a finger: press and hold anywhere on the card for a moment (about 150 milliseconds), drag it to another column, and release. A short click still opens the ticket, selects text, or operates the card's id chip and menu; a finger that moves at once scrolls the board instead. The state changes as soon as the card is dropped; a status message reads "Moved ACME-184 to In progress". There is no drag handle, so the card's whole width carries the ticket.
With the keyboard, focus the card itself (Tab reaches it before its title) and:
- press Space to pick the card up ("Picked up ACME-184. Use the arrow keys to move it to another column, space to drop, escape to cancel."),
- press the left or right arrow to move it between columns ("Over In progress"),
- press Space to drop it ("Dropped in In progress"), or Esc to cancel ("Move cancelled").
Drag is a shortcut, never the only way: the card menu's Move to… does the same. j and k move down and up the cards of a column; the card's title takes focus and Enter opens it.
Rules
- Columns. One column per active state, in the order set under Settings → Workflow and kinds, unless you have hidden some with Columns. Closed states are columns too. The number in a column header is the count of matching tickets in that state; on a closed column it counts only the tickets closed in the last 7 days.
- Card order in open columns. Highest priority first, then latest activity. A card that is edited, commented on, or moved rises within its column.
- Closed columns. A closed column shows only tickets closed within the last 7 days, most recently closed first. Tickets closed earlier are not on the board: the link at the bottom of the column, 12 older closed tickets, opens the Tickets list filtered to that state and the board's other filters, where every closed ticket can be found. The 7 days count from the moment the ticket entered a closed state; a comment on an old closed ticket does not bring it back to the board. Reopening a ticket moves it to an open column.
- Card contents. Id, title, kind, priority badge (none for the lowest priority unless it has a colour), billing client chip (workspace users only), assignee, and due date, with overdue marked when the ticket is open and past its date. A card in a closed column also shows when the ticket was closed, next to the assignee, since that is what the column is ordered by.
- Sub-tickets on cards. A sub-ticket shows its parent's id as a chip next to its own id (Show the sub-tickets of ACME-200 Release 3.2); selecting it narrows the board to that parent's sub-tickets. A parent shows a progress chip, "2/5" with a bar, counting the direct sub-tickets you may see and how many are closed; selecting it narrows the board the same way. A parent you may not see is not shown or counted; sub-tickets you may not see are left out of the count. Parents and their sub-tickets are ordinary cards in their own columns; there is no nesting inside a column, since a parent and its sub-tickets are often in different states.
- Show more. A column shows 20 cards; Show 20 more loads the next 20 in the same order, and the last batch says how many are left. Changing a filter or a column starts the column from the top again.
- Moving to a hidden state. Move to… lists every state. Moving a card to a state whose column is hidden takes it off the board; the status message says so ("Moved ACME-184 to Done, which this board does not show").
- Archived tickets never appear on a board.
- Refused moves. If you drop a card into a column you may not move it to, the card returns and the error is shown above the board.
- Shareable. The filters and the chosen columns are part of the page address, like the Tickets list. A saved board's address is
/w/acme/board/<id>; someone else opening it sees "This board no longer exists", because saved boards are personal. - Saved boards. Personal, at most 20 per workspace, 1–60 characters in the name, and an optional icon from the fixed set. The Sub-tickets filter is saved with the other filters. Removing a member deletes their saved boards. Saved boards are not part of the API for tokens; see Session-only operations.
- API.
GET /api/w/{slug}/boardreturns every column with its head of cards and anextCursorper column;stateIdslimits the columns,limitsets the head (the app uses 20; the default is 50), andclosedWithinDayswindows the closed columns (the app uses 7; without it every closed ticket is included).GET /api/w/{slug}/board/{stateId}continues one column. The MCP toolslist_boardsandget_boardread the same data. See the API reference.
Examples
A stand-up: open the project board, filter Assignee = Me, and drag today's card from To do to In progress.
A project manager reviews the Review column, opens each ticket from the card menu, and uses Assign to… to hand two of them to a colleague.
A consultant hides every column but Backlog and To do, sets Kind to Not Support, saves the result as Prioritise, and opens it every Monday from the sidebar to drag the week's work into To do.
Common problems
- I cannot drag cards. Regular client users without a project cannot move cards. If you can drag but the card returns, you are not allowed to set that state on that ticket.
- A ticket is missing from the board. It is archived, filtered out, in a column this board hides, or closed more than 7 days ago. The Tickets list with State = Any shows every ticket you may see; the older closed tickets link under a closed column leads there too.
- My saved board is gone. Only you can see your boards, and they belong to one workspace. If you were removed from the workspace and invited back, your boards were deleted with the membership.
- The columns are not in the order I want. An Owner or Admin orders states under Settings → Workflow and kinds; see Configure the workflow.