Skip to content
Help articles

Board rules

Let a board do one small thing for you when an item lands in a list or gets a label.

A rule makes a board do one small thing for you, the moment something happens. For example: when an item lands in Doing, set its due date to 3 days from now.

What a rule is

A rule has one trigger and one action.

The trigger is one of these:

  • An item lands in a list. That means it is created there, or moved there.
  • An item gets a label.

The action is one of these:

  • Add a label.
  • Assign a person, someone on the board.
  • Set a due date in a number of days from today, from 0 to 365. Today is counted in the board owner's own time zone, the one in the owner's account.
  • Move it to a list.

Make a rule

Open the board's ... menu, choose Board settings and then Edit next to Rules. Choose Add a rule, give it a name, pick the trigger and the action, and save. Use the switch on a rule to turn it off and on, and Delete to remove it. A rule does not change items that were already in the list. It acts on the items that land there from now on.

A rule acts on the item itself. Sub-items follow their parent and start no rules of their own.

Who can use rules

  • The board owner makes and changes the rules. On a team board that is the team owner. Guests and other members do not see them.
  • Rules are part of Pro. On Free the rules you have are kept and do not run. They run again when you are on Pro.
  • A board can have up to 25 rules.
  • A rule runs for every change, whoever makes it: you, a guest with Edit, or an AI on the board. It acts with the rights of the board, and only on this board.
  • Taking a change back with Undo starts no rules.

Rules and your AI

When a change made by an AI starts a rule, the rule runs as you set it up, with one exception. An AI below agent access level 5 (Full) cannot complete an item without your OK, so a rule does not complete one for it. If the rule would move the item into a Done list, that action is skipped and the history says "The rule was not applied: an AI change cannot complete an item". Adding a label, assigning a person and setting a due date still run. See Inbox and agent access.

What you see in the history

The change a rule makes is in the item's history, marked Rule: name, with the name you gave the rule. The person or AI whose change started the rule stays in the history as well.

What rules do not do

  • Rules use no AI. Listspace runs no AI for them.
  • A rule does not read or write text. It does not change a title, a description or a comment.
  • A rule does not decide anything. It does the same thing every time.
  • A rule sends no emails of its own. A person a rule assigns is told like any other assignment.
  • A rule works on one board only. It cannot act on another board.
  • A rule never starts another rule. If a rule adds a label, a rule that waits for that label does not run because of it.
  • There are no conditions yet. A rule cannot say "only if the item has a due date".

If you want an AI to do the thinking, your AI can work on the board within the agent access you set. See Inbox and agent access.

When a rule cannot run

If a list, a label or a person that a rule names is deleted, or the list is archived or moved to another board, the rule turns itself off and says why in the Rules window. Delete it and make it again with another list, label or person.

If the board is handed over to someone else, or moved into or out of a team, its rules turn off too, because the labels and the people are not the same anymore. Check a rule and turn it on again, or delete it.

A rule that cannot do its action on one item, for example because the person was removed from the board, skips that action. The change you made to the item stays.

Next: Sub-items

Still stuck? Write to hello@listspace.app and a person will answer.