--- title: "Smart Rules Actions" description: "Configure Smart Rules actions to control output devices with one-time, hold, toggle, timer, and impulse actions in TapHome." url: "https://taphome.com/en/docs/configuration/smart-rules-actions/" language: en lastmod: 2026-11-06 generator: hugo ai: topics: ["smart-rules-actions","automation-control","device-actions","lighting-control","blinds-control"] questions: ["What is the difference between One-time action and Hold action in TapHome Smart Rules?","When should I use Set range instead of Set value for a dimmer controlled by motion sensor?","How does the Timer action work and what happens when duration expires?","How do I access combined actions to control dimmer Value and Switch separately?","Why is the Toggle action only available as One-time action?","What does the Operation mode switch do and when should I use it?","How can I use Smart Rules to simulate button commands like Click, Double click, or Long press?"] --- # Smart Rules Actions Configure actions that control output devices when Smart Rule conditions are met Last updated: 2026-11-06 A Smart Rule action defines what happens to the output device when the condition of the rule is met, and you choose it on the action page of the Smart Rule. The set of actions you can choose from depends on the combination of input and output device used in the Smart Rule, for example Turn on, Turn off, Toggle, Set value, Set range, Impulses or Timer. Each action is applied either as a **One-time action**, which takes place once, or as a **Hold action**, which lasts as long as the condition lasts. The page also covers combined Switch and Value actions for dimmers, Multi-Value Switch actions, operation mode actions and command actions for push buttons and blinds. > Most of the **Smart rules** provide a set of actions to choose from. Keep in mind that set includes only actions relevant for input & output device combination used in the Smart rule. ## Action page ### Basic (default) set ![Smart Rule action page with the basic set of actions](https://taphome.com/documentation/smart-rules-actions/1-action-page-basic.png) **1. Action type** - predefined by the system **2. Basic set of actions** - most commonly used for the chosen output device type --- ### Advanced ("**Show more**" button) set ![Smart Rule action page with the advanced set of actions](https://taphome.com/documentation/smart-rules-actions/2-action-page-advanced.png) **1. Action type** - all available options, **Hold action** and **One-time action** (if applicable) **2. Advanced set of actions** - all available for chosen type of output device **3. Switch to automatic mode** - Available for **One-time action** only. Smart Rule performs an action and set device into **Automatic mode** (works only when there is another Smart Rule that could take the control over the output). This switch is very special and rarely used feature --- ## **Action type** - the way how the action is applied to the actuator ![Action type: one-time action and hold action](https://taphome.com/documentation/smart-rules-actions/3-duration-settings.png) **There are two main types of action:** **1. One-time action** - the action takes place once and immediately afterwards the Smart rule no longer controls the respective output. This type of action is typical for push buttons that works like an impulse but could be used for other devices. Icon for **One-time action** is not filled, just contoured by accent color. **2. Hold action** - the action is permanent, Smart rule controls the device as long as the condition for the action lasts. Icon for **Hold action** is filled by accent color. ## Actions in details ![](https://taphome.com/documentation/smart-rules-actions/symbol-setOn.svg) **On** Output device is turned ON ![](https://taphome.com/documentation/smart-rules-actions/symbol-setOff.svg) **Off** Output device is turned OFF ![](https://taphome.com/documentation/smart-rules-actions/symbol-setToggle.svg) **Toggle** If the output device is digital output (switch), action turns the switch into opposite state as it was before the action. If the device is **value** (dimmer, analog output etc.), action toggle value between 0% and **Value** (fixed) / **Last Value** (dynamic - value has been set manually or by other Smart rule as the non zero value before the action takes place). > Notice, that **Toggle** action is available as **One-time action** only. ![](https://taphome.com/documentation/smart-rules-actions/symbol-setValue.svg) **Set value** Value of the output device is set to desired level. Available for continuously controlled outputs (dimmers, analog outputs etc.). ![](https://taphome.com/documentation/smart-rules-actions/symbol-setRange.svg) **Set range** The device is set to the value from the defined range, which is closest to the last device value before the action > **Example:** Dimmed hallway light with push button and motion sensor. You want the button to turn the light to 100%, but the motion sensor should only set it to 20%. To avoid a situation where the user first turns on the light with the button to 100%, but then the motion sensor immediately detects them and reduces the value to 20%, the motion sensor should use "Set range: 20-100%". This way, when motion is detected, the value is set to the closest value within the defined range. If the light was at 0%, it will be set to 20%, but if it was anywhere between 20-100%, it will keep its current value and not be reduced back to 20%. ![](https://taphome.com/documentation/smart-rules-actions/symbol-setImpulse.svg) **Impulses** Output device is switched between two states/values defined as On and Off ![Toggle action settings with the ON and OFF state values](https://taphome.com/documentation/smart-rules-actions/14-combined-actions-example.png) **1. On State** - what state is considered to be ON **2. Off State** - what state is considered to be OFF **3. Delay** - Initial delay of the impulse action **4. Duration** - time specified for both actions (On and Off) **5. Repeat** - number of cycles (repetitions) - how many impulses are generated within the action --- ![](https://taphome.com/documentation/smart-rules-actions/symbol-setCurrentValue.svg) **Keep original** Output device is keeping actual state/value ![](https://taphome.com/documentation/smart-rules-actions/symbol-stopTimer.svg) **Stop timer** One-time action that stops timer action started by other Smart rule ![](https://taphome.com/documentation/smart-rules-actions/symbol-stop.svg) **None** No action. Smart Rule does nothing (is bypassed) and makes output device available for other Smart Rule or manual control. ![Timer action settings with initial delay and duration](https://taphome.com/documentation/smart-rules-actions/12-timer.png) **Timer** Allows performing action with some initial delay and duration. As One-time action it performs action once and then leaves output device to be available for other Smart Rules or manual control. As Hold action it performs action for specified time but after that it checks the state of the input device (trigger). If the trigger still keeps triggering state, timer keeps output device in the action state until release. Even then it leaves output device to be available for other Smart Rules or manual control. > Notice that Timer performs specified action only, never set the output device back to state it was before the action. --- ## Combined actions **Continuously controlled devices** (analog outputs, dimmers etc.) provide separate control for Switch (On/Off/Toggle) and Value. These duality is supported by the Smart Rule actions so you can choose whether the action affects the Switch or Value or Both. Such advanced feature allows you to control Switch by one Smart Rule and Value by another which is very useful for lighting management etc. **Basic view** ![Action page of a combined device, basic view](https://taphome.com/documentation/smart-rules-actions/19-operation-mode.png) **Advanced view** ![Action page of a combined device, advanced view](https://taphome.com/documentation/smart-rules-actions/20-operation-automatic.png) **Show more** - opens menu for combined action **Advanced view with combined action menu** ![Advanced view with the combined action menu](https://taphome.com/documentation/smart-rules-actions/21-operation-manual.png) **Value** - action settings for device value part only **Digital output** - action settings for device **Digital output** (Switch) part only --- ## Additional actions ### **Multi-Value Switch** actions ![](https://taphome.com/documentation/smart-rules-actions/symbol-setNext.svg) **Next** Sets the device to the next value in the sequence ![](https://taphome.com/documentation/smart-rules-actions/symbol-setPrevious.svg) **Previous** Sets the device to the previous value in the sequence ### Operation mode actions ![](https://taphome.com/documentation/smart-rules-actions/symbol-setAutomatic.svg) **Set Automatic mode** Sets the device **Operation mode** to **Automatic**, allowing Smart Rules to control the device ![](https://taphome.com/documentation/smart-rules-actions/symbol-setManual.svg) **Set Manual mode** Sets the device **Operation mode** to **Manual**, preventing Smart Rules from controlling the device --- ## Command actions These actions are typically used for specific device commands and advanced control scenarios. ### Push button commands ![](https://taphome.com/documentation/smart-rules-actions/symbol-performClick.svg) **Press** Simulates a button press ![](https://taphome.com/documentation/smart-rules-actions/symbol-performDoubleClick.svg) **Double click** Simulates a double button press ![](https://taphome.com/documentation/smart-rules-actions/symbol-performLongPress.svg) **Long press** Simulates a long button press ![](https://taphome.com/documentation/smart-rules-actions/symbol-performTrippleClick.svg) **Triple click** Simulates a triple button press ### Blinds calibration commands ![](https://taphome.com/documentation/smart-rules-actions/symbol-startCalibration.svg) **Start Calibration** Initiates the calibration process for blinds ![](https://taphome.com/documentation/smart-rules-actions/symbol-calibrateUp.svg) **Calibrate Up** Calibrates the upward movement of blinds ![](https://taphome.com/documentation/smart-rules-actions/symbol-calibrateDown.svg) **Calibrate Down** Calibrates the downward movement of blinds ### Blinds force mode commands ![](https://taphome.com/documentation/smart-rules-actions/symbol-forceUpStart.svg) **Force up start** Forces blinds to start moving up ![](https://taphome.com/documentation/smart-rules-actions/symbol-forceUpStop.svg) **Force up stop** Stops the forced upward movement ![](https://taphome.com/documentation/smart-rules-actions/symbol-forceUpTime.svg) **Force Up Time** Sets the duration for forced upward movement ![](https://taphome.com/documentation/smart-rules-actions/symbol-forceDownStart.svg) **Force down start** Forces blinds to start moving down ![](https://taphome.com/documentation/smart-rules-actions/symbol-forceDownStop.svg) **Force down stop** Stops the forced downward movement ![](https://taphome.com/documentation/smart-rules-actions/symbol-forceDownTime.svg) **Force Down Time** Sets the duration for forced downward movement **See also** — [Triggers](https://taphome.com/en/docs/smart-rules/triggers/), [Condition](https://taphome.com/en/docs/smart-rules/condition/).