# Editing sensor configuration

The **Edit sensor** button, located in the upper-right corner of the sensor view, allows **Administrators and Managers** to modify configuration, location, and operational settings for any selected sensor.

![](/files/5592c71cc1e1aac39590e497ef555e9c41038084)

## Changing Location

To move a sensor to a different location, select **Change location** from the edit menu. In the window that appears, choose the new location and click **Save**. The sensor will immediately be reassigned.

## Renaming a Sensor

To rename a sensor, select **Rename** from the edit menu. Enter the new name in the dialog box and click **Save** to apply the change.

## Swapping a Sensor

The **sensor swapping** feature allows you to replace a device without losing measurement history or interrupting monitoring. This is especially useful during periodic calibration, sensor replacement, or when upgrading hardware. Swapping keeps all configuration settings - such as alarm rules, automatic reports, integrations (e.g., webhooks), and formulas - intact. The new sensor immediately begins sending data using the original configuration, and the swap is logged in **Audit trails**. No additional license is required to perform sensor swapping.

**Swapping a Bluetooth Sensor**

For Bluetooth sensors, swapping can be done entirely from the Efento Cloud interface.

1. **Turn on the replacement sensor** and place it within the communication range of the gateway.
2. In Efento Cloud, open the sensor you want to replace and select **Swap device** from the edit menu.
3. Choose the replacement sensor from the list of available Bluetooth devices.

Once completed, all configuration settings are automatically transferred, and the new sensor takes over seamlessly.

**Swapping an NB-IoT Sensor**

NB-IoT sensors require activation and configuration through the **Efento Mobile Application**. Therefore, the swapping workflow uses the app instead of the Cloud interface.

1. Open the Efento mobile app, locate the sensor you want to replace, and **press and hold (long-click)** on it.
2. Select **Swap sensor** from the menu.
3. Follow the on-screen steps to activate the SIM card, configure the replacement sensor, and complete the swap.

After the process is finished, the replacement NB-IoT sensor automatically downloads configuration from Efento Cloud, continues measurements using the previous settings, and resumes data transmission normally.

<figure><img src="/files/7ApSgHsuZdSrNj9QTrXb" alt=""><figcaption></figcaption></figure>

## Formula Settings

For analog (4–20 mA / 0–10 V) sensors and pulse counters, you can modify the measurement conversion formula.\
If a formula already exists, a **Redefine** button appears. This allows the formula to be reapplied to the channel of a newly swapped sensor. For details on creating and managing formulas, refer to the [*Formulas*](broken://pages/x9zVgllFe45R0BzJ4W76) chapter.

![](/files/1e208a806ec4e2eae9988045a2d2465f6c10eb02)

## Remote Configuration of NB-IoT Sensors

NB-IoT sensors support remote configuration. To adjust their settings, select **Edit configuration** from the edit menu.\
A dialog displays the current parameters in the **Current** column. To apply changes, enter new values in the **Expected** column and save. Updated settings are applied the next time the sensor connects to the server (indicated by a synchronization icon).

You can modify:

* **Measurement interval -** Defines how often the sensor takes readings (in seconds). Minimum values depend on the sensor type.
* **Transmission interval -** Defines how often recorded data is sent to Efento Cloud (300–604,800 seconds). A warning appears if set below 1 hour, as this increases battery consumption.
* **ACK interval -** Determines how often the server confirms data transmission.
  * **Always** (recommended): every transmission is confirmed.
  * **Custom**: choose an interval (300–2,592,000 seconds). Larger intervals can extend battery life but increase the risk of lost data.
* **BLE turnoff time -** Enables remote control of the sensor’s Bluetooth interface.
  * **Always on**: Bluetooth remains available for mobile app access.
  * **Custom**: Bluetooth stays enabled for a defined period (60–604,800 seconds) after turning on the device, then turns off to save battery.

{% hint style="warning" %}
**Important:** When you swap a sensor, the replacement device automatically downloads and applies the configuration of the original one.
{% endhint %}

![](/files/d64d025a8a9e6abd19ecd159b5ece9b4525f9d6a)

## Disabling and Enabling Sensors

Sensors can be temporarily deactivated by selecting **Disable** from the edit menu.\
When disabled:

* Measurements are not saved,
* Webhooks are not triggered,
* Alarms are not generated.

The sensor status changes to **Disabled** until you re-enable it by clicking **Enable**.

## Archiving and Deleting Measurement Points

Efento Cloud allows you to archive or permanently delete measurement points:

#### **Archiving**

Removes a measurement point from the dashboard, reports, rules, and other areas, but **keeps its historical measurements**.\
Archived measurement points:

* Do not require licenses,
* Can be reassigned to new sensors,
* Remain available for viewing under Dashboard → Filters → *Archived*.

Archived measurement points can also be restored by selecting **Add sensor** and choosing a device to attach to the measurement point.

#### **Deleting**

Permanently removes the measurement point **and all associated data**. This action cannot be undone. A measurement point must be archived before it can be deleted.

Actions are available via the **Archive** or **Delete** options in the edit menu.&#x20;

## Calibration Reminder

For devices with calibration certificates, you can set a reminder to notify you when calibration is due. Options include:

* Reminder **24 months** after certificate issue,
* Custom interval (any number of months),
* No reminders.

Email notifications are sent one month before, and again on, the expiration date. Recipients are managed in the **Notification Manager**.

## Batch Actions

Administrators and Managers can perform edits on multiple sensors at once from the Dashboard:

1. Click **Batch actions** in the upper-left corner of the sensor table.
2. Select the sensors you want to modify.
3. Choose an action:
   * **Remove**,
   * **Change location**,
   * **Archive sensors**.

Batch actions make managing large sensor groups faster and more efficient.

![](/files/9b08ab9ea1a44d92d2417fc3be705c89c88c911f)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.efento.io/efento-cloud/advanced/editing-sensor-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
