Sieve Filters

What Are Sieve Filters?

Sieve is a server-side mail filtering language supported by many IMAP servers. In Cypht, Sieve filters let you define rules that run automatically on every new message as it arrives, as long as the filter is active.

Because the rules execute on the mail server itself, they work even when you are not logged into Cypht. Messages are sorted, flagged, forwarded, or discarded before they ever appear in your inbox view.

Step 1 : Enable the Sieve Filters Module

Before you can create any filter, the sievefilters module must be activated in your Cypht configuration. If the Sieve Filters section is already visible under Settings, you can skip this step.

Cypht 2.x (.env file)

Add sievefilters to the CYPHT_MODULES variable :

CYPHT_MODULES="core,imap,smtp,sievefilters"

Cypht 1.4.x (hm3.ini file)

Add a new module entry :

modules[]=sievefilters

After saving the configuration, reload or redeploy your Cypht instance. The Filters menu will then appear under the Settings tab.

Settings sidebar showing the Filters menu item

Step 2 : Create from the Sieve Filters Page

The most direct way to manage filters is through the dedicated Sieve Filters page in Settings.

Add a Filter

  1. Open Settings in the sidebar.
  2. Click Filters.
Filters page showing the selected email account
  1. Select the email account you want to manage.
  2. Click Add Filter.
Filter list with Add Filter and Add Script buttons
  1. Enter a filter name and set its priority.
Empty Add Filter modal with name, priority, conditions and actions fields
  1. Add one or more conditions (sender, subject, recipient, body, etc.).
  2. Set the test logic : use ALLOF if every condition must match, or ANYOF if any single condition is enough.
  3. Choose the action : move to folder, copy, flag, discard, redirect, etc.
Filled Add Filter form with conditions and redirect action
  1. Save the filter.

Add a Custom Script

Cypht now includes a Quick Actions dropdown in the message list controls so you can create, test, and reuse advanced filters without leaving the current view.

All saved filters and scripts appear in the list on the Sieve Filters page. Click any entry to open the edit modal where you can update conditions, change actions, or delete the filter entirely.

Step 3 : Create from Selected Messages

The Quick Actions dropdown in the message list toolbar lets you build filters directly from messages you are looking at, without navigating to Settings.

  1. Select one or more messages in the current mailbox view.
Inbox with selected messages and toolbar showing Quick Actions
  1. Click the Quick Actions button in the toolbar.
  2. Click Create from Selected.
Quick Actions dropdown showing Create from Selected option
  1. Review the auto-populated conditions (From addresses and Subject keywords are prefilled from the selected messages).
Setup Filter from selected messages modal with auto-populated From emails and Subject keywords
  1. Adjust the matching options :
    • From : Matches / Does Not Match
    • Subject : Contains / Does Not Contain / Ignore Subject
  2. Choose the action to apply.
  3. Click Dry Run to test the filter against messages already loaded in the list : matched and unmatched messages are shown in a results panel so you can verify the rule before committing.
  4. Save the filter.

Dry Run

The Dry Run button tests the current filter conditions against messages already loaded in the message list and shows which ones match and which do not, without moving or changing anything. It does not fetch additional messages from the server.

  1. Create a filter from selected messages or open an existing filter from the Quick Actions dropdown.
  2. Adjust the conditions, actions, and match logic.
  3. Click Dry Run in the modal.
  4. Review the matched and unmatched messages in the results panel.
  5. Close the results panel, refine the filter, and run it again if needed.
  6. Save only when the previewed behavior is correct.

Reuse and Edit Quick Actions

Filters created through this workflow are automatically marked as quick actions and appear in the Quick Actions dropdown for future use. Click any existing action in the dropdown to reopen its edit modal, adjust conditions, dry run it against the current messages, or delete it.

Step 4 : Create from an Opened Message

When you are reading a single email and want to filter similar messages in the future, use the Filter similar messages button.

  1. Open the message you want to base the filter on.
Opened message showing Filter similar messages button in the action bar
  1. Click Filter similar messages in the message actions area.
  2. Select the fields to match (From, To, Subject, Reply-To) and click Create filter.
Filter similar messages dropdown with From, To, Subject and Reply-To checkboxes
  1. Review the prefilled conditions : Cypht auto-populates the filter name, sender, recipient, and subject from the opened message.
Add Filter for message like this modal with auto-populated conditions and actions
  1. Adjust the conditions and choose the action (move, flag, discard, etc.).
  2. Save the filter.

Troubleshooting

On this page