Sorting & Grouping

Codecks comes with a powerful grouping mechanism. Learn how to slice and dice your cards to surface the important stuff.

Basic principles

Order options

The order button shows up in three contexts:

  1. Search results
  2. Decks
  3. Milestones

You can find it in the action bar to the left.

By default, cards will be grouped by Manual in milestones and by Priority everywhere else. By using the order panel (shortcut shift+o) you can pick any of the other available orders:

  • Priority*
  • Effort*
  • Workflow state*
  • Tags*
  • Owner*
  • Milestone*
  • Last updated
  • Creation date
  • Deck*
  • Project
  • Title
  • Upvotes
  • Time tracked
  • Due date
  • Manual (see below)

To get a more compact view, you can activate the Compact toggle at the bottom. This will group all cards into a single swim lane. Tags do not support a compact view as a card can show up multiple times if it has more than one tag.

Manual Order and Zones

Zones

Decks and Milestones have special order: Manual. This allows to define a custom order via drag and drop which is shared amongst the team.

Note that within Manual order, relative positioning of cards is preserved when moving them from one milestone or deck to the next.

Rather than working with predefined swimlanes, Manual order allows you to define Zones. Cards can be freely moved across and within Zones.

If you have the permission to modify the respective Deck or Milestone, you can create Zones via the Add Zone Button at the bottom. If you hover over the Zone name, you can modify its name or change the order. Empty zones can be deleted via the edit dialog.

When new cards are added (either via moving them into the deck or milestone, or via creating them directly) they are always added at the end of the top-most Zone.

The swim lane header

Swim lane header

The swim lane header consists of up to three parts:

  1. Swim lane label: Most sorting order allow you to click on the label to add the underlying property as a search entry. This allows you to quickly drill down on interesting properties by continuously iterating search terms and order.
  2. Select all button: This button only shows when hovering the area with the mouse. It allows you to quickly select all cards of the swim lane. Pro tip: if you selected a single card of a swim lane and hitting ctrl/cmd + a will select all cards of the current swim lane. Hitting ctrl/cmd + a once again will select all visible cards.
  3. Effort summary: if at least one card in a swim lane has an effort set, this section will be present. It shows the effort of all cards. The number in brackets indicate the number of cards without an effort set. I.e. cards with an effort of “None”.
  4. Time tracking summary: If at least one card has time tracking information associated with it, this section will be shown. Hovering it will show a pop which breaks down the tracked time by user.

Secondary search order

For cards that share the same attribute of the primary sort order there’s an implicit secondary sort order. It’s based on priority, then effort and lastly creation date. So if you order by e.g. “Owner”, then high priority cards will be shown first for each owner.

You can overwrite this behavior by ctrl/cmd + click on an order button. This will effectively push the selected sort order in front of the implicit order defined above. So if you picked “Milestone” as a secondary order while keeping “Owner” as primary order it’ll show cards in the nearest milestone first for cards with the same owner. Cards with the same owner and milestone will again use priority then effort and creation date to sort those further.

You can also define more than one secondary search order by ctrl/cmd + clicking on additional buttons. The number next to the button indicates the rank of the selected search order. To reset you can do a normal click on the primary order.

Preferred order

Swim lane header

Whenever you apply an order in a deck or in a milestone, this choice will be remembered for your browser. Note that the last used milestone order will be applied to all milestones whereas the deck order will be applied to the specific deck only.

To share your preferences with your team (or in case of a public deck with your audience) you can define a “Preferred order” for a deck. Do this by hitting the star icon at the top. When team members or visitors see the deck for the first time they will see cards in the preferred order. They can still pick their own order but will see a hint which will allow them to go back to the preferred order.