Butler | Board Name | Butler |
|---|
In order to perform actions on a board, user @butlerbot needs to be invited to the board.
When @butlerbot is invited to a board, it creates a "Butler" list where commands can be added. The list can be safely archived if not needed.
Commands can also be created in any other list, by creating a card with the command and adding @butlerbot as member in the card.
IMPORTANT: If you're a Business Class user, @butlerbot does NOT need to be added to your team. You don't have to pay for an extra team member to invite Butler to your boards.
Some actions can be executed immediately without a trigger. For example, this command:
will immediately sort the list after being entered.
Note that these actions can also be triggered, e.g.:
Scripts are a special kind of command that has an associated link, and it runs when someone clicks on the link.
The link can be in a card, an email, a website, etc. You can also use the link in conjunction with other automation tools such as Zapier or IFTTT to perform complex Trello actions that those tools don't support.
Read more about scripts here.
The "unique" option (advanced) creates the card only if one with the same title doesn't exist in the list. If the card already exists, the command stops (compare to the "find or create" command below).
This command creates the card only if one with the same title doesn't exist in the list. Whether the card is created or it already exists, the command continues with the created or found card as the active card.
Typically used with a trigger such as when a card ends with.
Typically used with a trigger such as when a card ends with.
The trigger card is the one that cause the trigger to start the actions, as opposed to one created or found in a prior action within this command.
Finds an existing checklist with that name on the board and copies it to the card. If you want to copy the checklist from a particular card, the "from card" option (advanced) allows you to specify the source card name or link. The "with name" option (advanced) renames the copy of the checklist.
Typically used with a trigger such as when a card contains a date.
Unlike setting the due date, moving it respects the existing time (e.g. move an appointment to another day).
Unlike setting the due date, moving it respects the existing date (e.g. move an appointment to different time on the same day).
Use this command to automatically silence notifications from cards assigned to members:
when a member is added to a card, unsubscribe the member from the card
Useful in combination with triggers involving a checklist item, e.g. "when a checklist item contains a date".
If the "linked" option is selected (advanced), this command replaces the checklist item with a link to the newly created card.
If the "linked" option is selected (advanced), this command replaces the checklist item with a link to the newly created card.
Repeats the actions following it for each member. Use in conjunction with the {matchedusername}, {matchedfullname}, and {matchedinitials} variables.
Repeats the actions following it for each label in a card or on the board. Use in conjunction with the {labelname} and {labelcolor} variables.
Repeats the actions following it for each checklist on a card. Use in conjunction with checklist actions and/or the {checklistname} variable.
Repeats the actions following it for each checklist item on a card. Use in conjunction with checklist item actions and/or the {checklistname}, {checklistitemname} and {checklistitemstate} variables.
Repeats the actions following it for each attachment on a card. Use in conjunction with the {attachmentname} and {attachmentlink} variables.
Repeats the actions following it for each list on a board. Use in conjunction with the {listname} variable.
Repeats the actions following it for each card in a list. Use in conjunction with any action that works on a card, and variables such as {cardname} and {cardlink}.
The "except the trigger card" option (advanced) allows to filter out the card that caused the command to trigger.
Repeats the actions following it for each card linked from the current card, either in the description or as attachments. Use in conjunction with any action that works on a card, and variables such as {cardname} and {cardlink}.
Repeats the actions following it for each card linked in items in a checklist. Use in conjunction with any action that works on a card, and variables such as {cardname} and {cardlink}.
Performs the actions following it on the copied card instead of the original (only works after a copy command).
Performs the actions following it on the trigger (initial) card instead of the current card (e.g. after a new card is created, go back to the trigger card to add a link with {newcardlink}).
By default, after performing an action Butler posts a comment explaining what it just did. Turning silent on removes these comments. Butler will still issue a comment if there's an error executing the command.
By default, Butler adds a sticker to the card when it understands a command. You can disable this behavior with this command.
The timezone is important for scheduled commands, and for commands that operate on due dates. The timezone shown has been automatically detected from your browser settings.
| Date | Message |
|---|
Note that this condition will only work in actions such as for each card inactive for more than 30 days or count the cards inactive for more than 5 working days, but not on triggers such as when a card inactive for more than 7 days is moved to "To Do" because the card becomes active before the trigger is evaluated.