Build and manage automations
Automation rules should be specific, testable, and easy to explain. A strong rule uses a clear trigger, narrow conditions, a safe action, and a controlled scope.
A safe automation setup should help you:
- Plan a new automation rule.
- Build a rule in the automation builder.
- Review and change an existing rule.
- Confirm access, plan, and network requirements.
- Test behavior before relying on it.
Builder State Reference
| State | What to do |
|---|---|
| Loading | Wait for the builder to initialize. |
| Retry | Select Retry. If it repeats, refresh the app and confirm network access. |
| No internet | Reconnect before opening or changing rules. |
| No access | Ask a Space admin to review your role. |
| Upgrade prompt | Ask the billing owner to review plan availability. |
| Builder loaded | Create, review, and manage rules from the builder. |
Rule Design Reference
| Part | Definition | Good practice |
|---|---|---|
| Name | The label people see in the builder. | Use a plain-language purpose, such as Assign reviewer when task moves to Review. |
| Trigger | The event that starts the rule. | Choose the most specific event available. |
| Condition | Requirements that must be true before the action runs. | Add conditions to prevent accidental matches. |
| Action | The update, notification, assignment, reminder, or other operation performed. | Keep the first version low-risk. |
| Scope | The Space, List, or work area where the rule applies. | Start narrow, then expand only after testing. |
| Status | Whether the rule can run. | Pause or disable rules while investigating unexpected behavior. |
Before you start
- You must be in the correct Space.
- Your role must allow automation access.
- Your plan must include automation access.
- Use safe test items before relying on the rule for real work.
Plan the rule before building
Write the rule in this format:
When [trigger] happens, if [condition] is true, then [action].
Examples
- When a task moves to Review, assign the reviewer.
- When a task is marked blocked, notify the team.
- When a follow-up date is added, create a reminder.
Create an automation
- Open Automations.
- Wait for the builder to load.
- Start a new rule.
- Name the rule clearly.
- Choose the trigger.
- Add conditions.
- Choose the action.
- Confirm scope.
- Save the rule.
- Test with a safe item.
Expected outcome: The automation is saved and only affects matching work.
Manage an existing automation
- Open Automations.
- Select the rule you want to review.
- Check name, trigger, conditions, action, scope, and status.
- Pause or disable the rule if behavior is uncertain.
- Edit one part at a time.
- Save and retest.
Safe setup checklist
Before relying on a rule, confirm:
- The trigger is specific.
- Conditions prevent broad matches.
- The action is safe.
- Scope is limited to the intended area.
- A test item produced the expected result.
- The affected team understands the automatic update.
- You know how to pause or disable the rule if needed.
Troubleshooting
Builder keeps showing Retry
- Symptom: The builder does not open after retrying.
- Cause: Session, network, service availability, or initialization details may be missing.
- Resolution:
- Confirm you are online.
- Refresh the app.
- Confirm the current Space loaded correctly.
- Try again.
- Report the approximate time and Space if it still fails.
Rule affects too much work
- Symptom: More items change than expected.
- Cause: Trigger, conditions, or scope are too broad.
- Resolution:
- Pause or disable the rule if available.
- Narrow scope.
- Add stricter conditions.
- Test with one matching and one non-matching item.
People are surprised by automatic changes
- Symptom: Team members do not know why work changed.
- Cause: The rule name or team process may not explain the automation.
- Resolution:
- Rename the rule so its purpose is clear.
- Tell affected users what trigger causes the action.
- Keep high-risk decisions manual.
FAQ
How broad should a new rule be?
Start narrow. Expand only after a safe test proves the behavior.
Should I edit a rule while it is causing unexpected updates?
Pause or disable it first if the builder provides that option. Then edit, test, and re-enable.