Skip to content

Intro to Workflow Control

Video Placeholder Duration: 5-7 minutes Topics covered: Custom automations, triggers, conditions, actions, automation examples


What is Workflow Control?

Workflow Control (Custom Automations) lets you automate actions in your project based on triggers and conditions. When something happens, if certain conditions are met, Plane automatically performs actions.

The formula: When [trigger] happens, if [conditions] are met, then [actions] execute.


Why Automate Workflows?

Manual Process

  • Remember to update related items
  • Manually assign based on labels
  • Notify team members yourself
  • Risk of forgetting steps

Automated Process

  • Updates happen automatically
  • Assignments follow rules
  • Notifications sent consistently
  • No manual intervention

Automation Components

Triggers

Events that start the automation:

  • Work item created
  • Work item updated
  • State changed
  • Assignee changed
  • Comment added

Conditions

Optional filters that must be true:

  • Work item state equals X
  • Work item type is Y
  • Label includes Z
  • Priority is High
  • Creator is Person A

Actions

What happens when triggered:

  • Change property (state, priority, assignee, labels, dates)
  • Add comment
  • Send notification

Creating an Automation

Access Automations

  1. Go to Project Settings
  2. Navigate to Automations section
  3. Click Create Automation

Step 1: Name Your Automation

Give it a clear, descriptive name:

  • "Auto-assign bugs to QA"
  • "Notify on high priority"
  • "Close stale items"

Step 2: Set the Trigger

Choose when the automation runs:

TriggerWhen It Fires
Work item createdNew item added
Work item updatedAny property changes
State changedStatus transitions
Assignee changedAssignment updates
Comment addedNew comments posted

Step 3: Add Conditions (Optional)

Filter which items the automation applies to:

ConditionExample
State equals"In Progress"
Type is"Bug"
Label includes"urgent"
Priority is"High" or "Urgent"
Assignee is"Alice"
Created by"Support Team"

Step 4: Define Actions

What should happen:

ActionOptions
Change StateMove to any state
Change PrioritySet priority level
Change AssigneeAssign to person/team
Add LabelsApply specific labels
Set Due DateRelative or specific
Add CommentAutomated message

Step 5: Enable

Toggle the automation on to activate it.


Automation Examples

Auto-Assign Bugs

When: Work item created
If: Type = Bug AND Label includes "frontend"
Then: Assign to Frontend Team Lead

Priority Escalation

When: State changed to "In Progress"
If: Priority = Urgent
Then: Add comment "⚠️ High priority item started"

Stale Item Cleanup

When: Work item updated
If: State = "In Review" AND Last updated > 7 days ago
Then: Add comment "This item needs attention"

Auto-Labeling

When: Work item created
If: Title contains "bug" OR "fix"
Then: Add label "bug"

Team Notification

When: State changed to "Done"
If: Label includes "customer-facing"
Then: Add comment "✅ Ready for customer communication"

Stacking Conditions and Actions

Multiple Conditions

Conditions combine with AND logic:

  • Type = Bug AND
  • Priority = High AND
  • Label includes "security"

All must be true for the automation to run.

Multiple Actions

Stack multiple actions in one automation:

  1. Change state to "In Review"
  2. Assign to QA Lead
  3. Add comment "Ready for testing"

Managing Automations

View All Automations

See all automations in Project Settings → Automations:

  • Name and description
  • Enabled/disabled status
  • Trigger and conditions summary

Edit Automations

  1. Find the automation
  2. Click Edit
  3. Modify trigger, conditions, or actions
  4. Save changes

Enable/Disable

Toggle automations on/off without deleting:

  • Test new automations
  • Temporarily pause
  • Troubleshoot issues

Delete

Remove automations you no longer need:

  1. Find the automation
  2. Click Delete
  3. Confirm

Activity Panel

Monitor automation history:

  • When automations ran
  • What they did
  • Any errors or issues

Automation Best Practices

Start Simple

Begin with straightforward automations:

  • Single trigger
  • Few conditions
  • One action

Test Before Enabling

Create a test work item to verify:

  • Automation triggers correctly
  • Conditions filter properly
  • Actions execute as expected

Clear Naming

Name automations descriptively:

  • ✅ "Assign security bugs to SecOps"
  • ❌ "Automation 1"

Document Your Automations

Keep a reference of what each does:

  • Why it exists
  • What it affects
  • Who maintains it

Review Periodically

As processes change:

  • Update automations
  • Remove obsolete ones
  • Add new ones

Avoid Loops

Be careful not to create circular automations:

  • Automation A triggers Automation B
  • Automation B triggers Automation A
  • Infinite loop!

Key Takeaways

  • Workflow Control automates actions based on triggers and conditions
  • Triggers: item created, updated, state changed, etc.
  • Conditions: filter which items are affected
  • Actions: change properties, add comments
  • Access in Project Settings → Automations
  • Stack multiple conditions and actions
  • Enable/disable without deleting
  • Start simple and iterate

Next Steps

Track the status of projects themselves with Project States.

Next Lesson: Intro to Project States

Plane University