> For the complete documentation index, see [llms.txt](https://docs.widgelix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.widgelix.com/actions-formerly-rule-engine/introduction.md).

# Introduction

**Actions** (formerly **Rule Engine**) let Widgelix react automatically to what your assets report. Every action follows a simple **IF → IS → THEN** logic:

* **IF** a data field of one or more assets (or an asset/gateway connectivity change) ...
* **IS** in a given state (compared with a constant, with another asset's measurement, or with a geofence) ...
* **THEN** do something: send an email, Slack, Discord, SMS or SIGNL4 alert, call a webhook, send a downlink to a device, or just log an event.

On top of this logic you can control **when** and **how often** an action fires (rate limiting, trigger once, schedule, temporal control, switching threshold range), suppress noisy child alerts with **Action Dependencies**, and route unacknowledged alerts through an **Escalation Chain**.

{% hint style="info" %}
The module was renamed from **Rule Engine** to **Actions**. Related terms were renamed too: **Devices** are now **Assets** and **Device Types** are now **Asset Templates**. Everything described for rules in older material applies to actions.
{% endhint %}

## The Actions page

Open **Actions** in the left sidebar to see all actions of the current organization.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2F13DRJg2xppPbx6xlq5fU%2Factions-list.png?alt=media&amp;token=9fbca4d7-ca7f-4c16-9054-ca3fe3362f93" alt="Actions list page"><figcaption><p>Actions list (demo data)</p></figcaption></figure>

The table shows for each action:

| Column            | Description                                                                                                             |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Name**          | Action name. A **DISABLED** badge is shown for actions that are switched off. Click the name to open the action editor. |
| **Type**          | Severity: **Info**, **Warning** or **Critical** (shown as *Danger* in the editor).                                      |
| **Channels**      | Where the action sends its output: Email, SMS, Slack, Discord, Webhook, SIGNL4, Downlink or Event only.                 |
| **Last executed** | When the action last fired (relative time and exact timestamp), or **Never**.                                           |

At the end of every row you will find:

* **Clone action** (copy icon): creates a copy of the action that you can adjust, which is the fastest way to build similar actions for different assets.
* **Enable / disable toggle**: switches the action on or off without opening it.

### Filtering and search

* **Search by name**: filter the list by action name.
* **Type filter**: All types / Info / Warning / Critical, with the number of actions of each type.
* **Status filter**: All / Enabled / Disabled / **With errors** (actions that have errors).
* **Fit screen / Expand**: fit the table into the window (scrolling inside the table) or expand it to full page height.
* **Rows per page** and pagination at the bottom of the table.

Click **+ Add action** in the top right corner to create a new action. See [Creating an Action](https://docs.widgelix.com/actions-formerly-rule-engine/creating-an-action.md).

## In this section

* [Creating an Action](https://docs.widgelix.com/actions-formerly-rule-engine/creating-an-action.md): step-by-step walkthrough of the action editor.
* [Action Types & Placeholders](https://docs.widgelix.com/actions-formerly-rule-engine/action-types-and-placeholders.md): what each THEN action does and how to insert asset data into messages.
* [Action Dependencies](https://docs.widgelix.com/actions-formerly-rule-engine/action-dependencies.md): suppress child alerts while a parent action is active.
* [Escalation Chain](https://docs.widgelix.com/actions-formerly-rule-engine/escalation-chain.md): assign alerts to people and escalate them when nobody acknowledges.
* [Temporal Control](https://docs.widgelix.com/actions-formerly-rule-engine/temporal-control.md): fire only when a condition holds for a period of time.
* [Comparison Equations](https://docs.widgelix.com/actions-formerly-rule-engine/comparison-equations.md) and [Condition Types](https://docs.widgelix.com/actions-formerly-rule-engine/condition-types.md): how conditions are evaluated.
