Skip to main content

Multi-Action Rules: Configure Actions and Recovery

Multi-action rules associate a category with several configured effects. The category editor offers a primary action—Move to folder, Keep in inbox or Delete—and optional effects such as marking read, starring and forwarding.

Describe the category, then configure its actions

For a fictional vendor invoice, specify the vendor name and exclude newsletters. Choose a finance review folder and, if useful, a flag. An instruction like “file and forward this” in the prompt does not replace the action fields.

Forwarding with a summary also attaches the original message. Verify the recipient before enabling it. Marking a message read can reduce its visibility, so test that separately from its folder placement.

Set up a rule in the category editor

  1. Open the mailbox, go to Rules and, in the Categories card, click Add Category or the edit icon of an existing one.
  2. Fill in Category Name and LLM Prompt Description. The description is what the model compares each message with.
  3. Under What happens to matching emails, choose exactly one primary action: Move to folder, Keep in inbox or Delete. For a move, pick the Target Folder from the list or type a new name; a folder that does not exist yet is created. For Delete, choose Move to trash or Delete permanently.
  4. Under Plus, optionally, switch on Mark as read, Star (flag as important) or Forward to address. Each can be used once per category, and a forward takes one recipient address.
  5. Click Create or Save. The switch next to each category enables or disables it; a disabled category is not offered to the model.

A worked example

A category “Vendor invoices” has the description “Invoices and payment requests from Northwind Supplies. Not newsletters or product news.” Its primary action is Move to folder “Finance review”. Star and Forward to bookkeeping@example.com are switched on.

When “Invoice 2291” arrives and the model chooses this category, the message is starred, a copy is forwarded and the message is moved to Finance review. History then shows one entry: Move → Finance review, ”+ star” and ”+ forward → bookkeeping@example.com”.

The order in which actions run

The order is fixed and does not depend on the order in which you switched the options on: star, mark as read, forward, and only then the move or delete. The optional actions therefore run while the message is still in the inbox.

Review each effect

EffectRecovery boundary
MoveHistory can attempt a supported move back while the message is accessible
DeleteAutomatic reversal is unsupported; check Trash if deletion was not permanent
ForwardDelivered copies cannot be recalled
Read or flag changeDo not assume undo of the move reverses all optional effects

The editor offers Trash and permanent deletion modes. Begin with moves rather than permanent deletion; provider Trash retention is a separate condition.

What happens when one step fails

If one step fails, for example because the forward cannot be sent, handling of that message stops. The remaining steps are skipped and no History entry is written. Automatic processing stops its run at that message and tries it again on the next run. A manual run reports the error and continues with the other messages.

Steps that already ran are not rolled back. A message can end up starred but not moved, and a message that is tried again can be forwarded a second time if a later step failed after the forward had been sent.

Common questions

Can a category have two primary actions or two forward recipients?

No. A category has one primary action, each optional action at most once, and one forward address. To send the same kind of mail to two people, forward to an address that distributes it, such as a shared mailbox.

Which actions count if I edit the category after a preview?

When you apply a manual run, the actions the category has at that moment are used, even if you changed them after the messages were classified. Review the category again before you click Move.

What happens to a message that fits no category?

It stays in the inbox and is recorded in History as Keep. The same happens when the model’s answer does not name one of your categories exactly. The “Uncategorized” category is part of every mailbox and cannot be deleted.

Can “Move to trash” delete a message for good?

Not on its own. In this mode the message is moved to the trash folder of your mailbox; if that move fails, the message stays where it is. How long the trash keeps messages is up to your provider.

Test a small batch first

Write expected folder, read status, flag and recipients before previewing. Apply only reviewed examples, then verify the original mailbox and action history. A category match does not prove every configured effect succeeded.

See History and Undo, forwarding details and the organization guide.

Ready to put your inbox on autopilot?

Get Started Free