> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.kodelabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create and manage manual meters

> Register offline utility meters, log readings, and manage meter devices in Cloud BMS for trending and analytics

<Info>
  Manual meters is a building-level module. Select a building from the [sites list](/products/kode-os/sites-and-map), then open **Devices** > **Batch Update** > **Manual Meters**.
</Info>

Manual meters bridge automated smart meters and unconnected utility meters that still rely on spreadsheets or paper logs. You create a structured device for offline utility meters, then log readings on the web or mobile. Cloud BMS applies conversion factors so manual data can power dashboards, historical trending, billing workflows, and API access like connected device data.

Each manual meter is stored as a **device** with an accumulator point for its readings. Logged values appear in **Reading Logs** as a table and in **Trends** as time-series data. After you create a meter, open it from the **Manual Meters** list or search for it on the main [Devices](/products/kode-os/devices/devices) list.

## Supported meter types

You can create these manual meter types:

* Electric Meter
* Energy Meter
* Water Meter
* Steam Meter
* Gas Meter

## Navigate to Manual Meters

<Steps>
  <Step title="Select your site">
    Click **Sites** in the left navigation bar and select the building you want to manage.
  </Step>

  <Step title="Open Manual Meters">
    Click **Devices** in the building sidebar, then select **Batch Update**. Select **Manual Meters** in the batch update menu.
  </Step>
</Steps>

<Frame caption="The Manual Meters list shows meter metadata columns, search, filters, and actions to add meters or readings">
  <img src="https://mintcdn.com/kodelabs/njejy12QoNdTJ3U4/images/kode-os/devices/kode-os-devices-manual-meters-list.png?fit=max&auto=format&n=njejy12QoNdTJ3U4&q=85&s=7e141dd45e68787dbf31cb01aa16f954" alt="Manual Meters page with search bar, Filters and Add Meter buttons, and table columns for Name, Location, Area, Connector, Meter Type, Storage Unit, Conversion Factor, and Serial Number" width="1024" height="546" data-path="images/kode-os/devices/kode-os-devices-manual-meters-list.png" />
</Frame>

Use **Search for meters** to find a meter by name. Click **Filters** in the header to narrow the list by connector, meter type, area, or other fields.

## Create manual meters

Manual meters are created in a table-based dialog so you can add one or many meters in a single save.

<Steps>
  <Step title="Open Add Meter">
    On the **Manual Meters** page, click **+ Add Meter**.
  </Step>

  <Step title="Add rows">
    In the **Add Meters** dialog, each row is one meter. Click **+ Add Row** to add more rows. Use the row actions to duplicate or delete a row.
  </Step>

  <Step title="Enter required fields">
    Fill in these columns for each row:

    | Column                  | Description                                                                                                |
    | ----------------------- | ---------------------------------------------------------------------------------------------------------- |
    | **Meter Name**          | Display name for the meter device                                                                          |
    | **Connector**           | Data connector assigned to the meter device (for example, `N4` or `jace`)                                  |
    | **Meter Type**          | Canonical type (for example, `energyMeter` or `electricMeter`)                                             |
    | **Unit of Measurement** | Storage unit for readings (for example, `kWh` or `BTU`)                                                    |
    | **Conversion Factor**   | Multiplier applied to native readings (defaults to `1.0`). Stored value = native value × conversion factor |
  </Step>

  <Step title="Save meters">
    Click **Add Meters** to create the devices.
  </Step>
</Steps>

<Note>
  The **Connector** field assigns the meter to a data source in your site. It does not change how readings are captured or stored.
</Note>

<Tip>
  Use **Conversion Factor** when the physical meter displays a different unit than you want to store. For example, enter a factor that converts watt-hours (`Wh`) on the dial to kilowatt-hours (`kWh`) in storage.
</Tip>

<Frame caption="The Add Meters dialog supports multiple rows with required meter fields and optional metadata columns">
  <img src="https://mintcdn.com/kodelabs/njejy12QoNdTJ3U4/images/kode-os/devices/kode-os-devices-manual-meters-add-meters.png?fit=max&auto=format&n=njejy12QoNdTJ3U4&q=85&s=530223d9bb664b668e60010377b3c7fa" alt="Add Meters modal with table rows for Meter Name, Location, Area, Connector, Meter Type, Unit of Measurement, and Conversion Factor, plus Add Metadata and Add Row buttons" width="1024" height="234" data-path="images/kode-os/devices/kode-os-devices-manual-meters-add-meters.png" />
</Frame>

### Add optional metadata columns

Click **+ Add Metadata** to show extra columns in the table before you save.

<Frame caption="Add Metadata lists general and detail fields you can expose as columns in the Add Meters table">
  <img src="https://mintcdn.com/kodelabs/njejy12QoNdTJ3U4/images/kode-os/devices/kode-os-devices-manual-meters-add-metadata.png?fit=max&auto=format&n=njejy12QoNdTJ3U4&q=85&s=11ba30c051cf5a7b3077504406d40403" alt="Add Metadata dropdown with General Information fields Location and Area checked, and Details fields such as Serial Number, Identifier, Description, Vendor, Manufacturer, and Model" width="322" height="450" data-path="images/kode-os/devices/kode-os-devices-manual-meters-add-metadata.png" />
</Frame>

<Steps>
  <Step title="Select metadata fields">
    In **Add Metadata**, select the fields you want as columns. Examples include **Location**, **Area**, **Serial Number**, **Identifier**, **Description**, **Vendor**, **Manufacturer**, and **Model**.
  </Step>

  <Step title="Enter values and save">
    Fill in the new columns for each row, then click **Add Meters**.
  </Step>
</Steps>

<Tip>
  **Area** captures the meter's space placement when your site uses areas. **Location** is an additional contextual field depending on how your organization labels floors or zones.
</Tip>

## Add readings in batch

Batch entry adds one reading per selected meter in a single save.

<Steps>
  <Step title="Select meters">
    On the **Manual Meters** page, select the checkboxes for the meters you want to update.
  </Step>

  <Step title="Open Add Reading">
    Click **Add Reading** in the bottom-right corner.
  </Step>

  <Step title="Enter reading data">
    In the **Add Readings** dialog, set **Date & Time** and **Value** for each selected meter. Review **Value Preview** to confirm the stored value (native value × conversion factor).
  </Step>

  <Step title="Add attachments or notes (optional)">
    Use **Attachments** (**+ Add**) or the **Notes** column when you need supporting files or context.
  </Step>

  <Step title="Save readings">
    Click **Add Readings**.
  </Step>
</Steps>

<Frame caption="Select multiple meters on the Manual Meters list, then use Add Reading for batch entry">
  <img src="https://mintcdn.com/kodelabs/njejy12QoNdTJ3U4/images/kode-os/devices/kode-os-devices-manual-meters-list-selected.png?fit=max&auto=format&n=njejy12QoNdTJ3U4&q=85&s=87d80ef9b29a1d7d38d5e18c0a1e84c9" alt="Manual Meters list with Meter 3 and Meter 4 selected and Add Reading button visible in the bottom right" width="1024" height="434" data-path="images/kode-os/devices/kode-os-devices-manual-meters-list-selected.png" />
</Frame>

<Frame caption="The Add Readings dialog collects date, value, preview, attachments, and notes per meter">
  <img src="https://mintcdn.com/kodelabs/njejy12QoNdTJ3U4/images/kode-os/devices/kode-os-devices-manual-meters-add-readings.png?fit=max&auto=format&n=njejy12QoNdTJ3U4&q=85&s=aad1f2e778b2d969f860342d86ef0737" alt="Add Readings modal with rows for Meter 4 and Meter 3 showing Date and Time, Value, Value Preview, Attachments, and Notes columns" width="1024" height="244" data-path="images/kode-os/devices/kode-os-devices-manual-meters-add-readings.png" />
</Frame>

<Warning>
  If the entered value is lower than the previous reading for that meter, the **Value Preview** cell shows a warning (for example, *Value is less than the previous one: 320 kWh, please verify.*). Confirm the reading on the physical meter before you save.
</Warning>

<Frame caption="A warning icon appears when a new value is less than the prior reading for the same meter">
  <img src="https://mintcdn.com/kodelabs/njejy12QoNdTJ3U4/images/kode-os/devices/kode-os-devices-manual-meters-reading-validation.png?fit=max&auto=format&n=njejy12QoNdTJ3U4&q=85&s=0e705e071ae67fd9a1bd75641940a267" alt="Add Readings row with Value Preview showing orange highlight and tooltip stating value is less than the previous one 320 kWh please verify" width="634" height="138" data-path="images/kode-os/devices/kode-os-devices-manual-meters-reading-validation.png" />
</Frame>

## Reading rules and validation

These rules apply when you add readings on the web or mobile.

### Date and order

* Each reading's date and time must be **later than** the last saved reading for that meter.
* You can add historical readings up to **six months** before the meter was created.
* When backfilling history, enter readings in chronological order. Start with the earliest month and work forward.

### Values and corrections

* Enter the **native value** shown on the physical meter. **Value Preview** shows the stored result (native value × conversion factor).
* Accumulator readings should increase over time. If a new value is lower than the previous reading, verify the meter before you save. You can still proceed after confirmation.
* You can delete only the **most recent** reading to correct a mistake. Older readings cannot be removed.
* There is no limit on how many readings you can add per month.

### Attachments and notes

Add photos, files, or notes with a reading to support verification and audit workflows. On mobile, you can capture a photo as an attachment in the field.

## Manage a meter from Devices

After creation, each manual meter appears as a device on the main **Devices** list.

<Steps>
  <Step title="Open Devices">
    Click **Devices** in the building sidebar (not only **Manual Meters**).
  </Step>

  <Step title="Find the meter">
    Use the search bar or filters to find the manual meter by name. Open the device by clicking its name in the list.
  </Step>

  <Step title="Open Device Details">
    On the device page, select the **Device Details** tab (alongside **Trends** and other tabs).
  </Step>
</Steps>

### Reading logs

The **Reading Logs** section at the top of **Device Details** lists historical entries.

<Frame caption="Device Details shows Reading Logs with dates, values, attachments, and Add Reading Log">
  <img src="https://mintcdn.com/kodelabs/njejy12QoNdTJ3U4/images/kode-os/devices/kode-os-devices-manual-meters-reading-logs.png?fit=max&auto=format&n=njejy12QoNdTJ3U4&q=85&s=f8eeee1d033f4b8df26b613247cf4f72" alt="Manual Meter 2 device page on Device Details tab with Reading Logs table showing Reading Date, Value, and Attachments columns and Add Reading Log button" width="1024" height="448" data-path="images/kode-os/devices/kode-os-devices-manual-meters-reading-logs.png" />
</Frame>

<Steps>
  <Step title="Add a single reading">
    Click **+ Add Reading Log**. Enter **Value** and **Date & time**. Optionally add attachments or notes, then save.
  </Step>

  <Step title="Review log details">
    Expand a row to see **Native Reading**, **Conversion Factor**, **User**, **Notes**, and attachment previews.
  </Step>
</Steps>

<Frame caption="Expand a reading log row to view native value, multiplier, user, and notes">
  <img src="https://mintcdn.com/kodelabs/njejy12QoNdTJ3U4/images/kode-os/devices/kode-os-devices-manual-meters-reading-logs-expanded.png?fit=max&auto=format&n=njejy12QoNdTJ3U4&q=85&s=f73c43ef61536adb2f1851179c4786fe" alt="Expanded reading log row showing Native Reading 200 kWh, Billing Multiplier 1.0, User Granit Gojani, and Notes field" width="1024" height="397" data-path="images/kode-os/devices/kode-os-devices-manual-meters-reading-logs-expanded.png" />
</Frame>

To correct a mistake, use the delete action on the **most recent** reading only. See [Reading rules and validation](#reading-rules-and-validation) for date, order, and deletion limits.

### Edit or delete the meter

Scroll past **Reading Logs** to the **Device Details** section at the bottom of the tab.

<Frame caption="The Device Details section provides Edit Device and delete actions for the meter">
  <img src="https://mintcdn.com/kodelabs/njejy12QoNdTJ3U4/images/kode-os/devices/kode-os-devices-manual-meters-device-details.png?fit=max&auto=format&n=njejy12QoNdTJ3U4&q=85&s=9ea07012587a270b769499d8396f22c5" alt="Device Details section showing general device fields, Meter Metadata with Source Form Manual and Conversion Factor, and Edit Device and delete buttons in the header" width="1024" height="489" data-path="images/kode-os/devices/kode-os-devices-manual-meters-device-details.png" />
</Frame>

* Click **Edit Device** to change name, location, connector, meter type, conversion factor, serial number, and other metadata.
* Click the **delete** button to remove the meter from the site. Confirm when prompted.

In **Meter Metadata**, **Source Form** shows **Manual** for meters created through this workflow.

## Related topics

<CardGroup cols={2}>
  <Card title="Devices" icon="cpu" href="/products/kode-os/devices/devices">
    Browse, filter, and manage all building devices including manual meters.
  </Card>

  <Card title="Trends" icon="chart-line" href="/products/kode-os/trends">
    Chart manual meter point history alongside other building data.
  </Card>

  <Card title="Manual meters on mobile" icon="smartphone" href="/products/mobile-app/building/manual-meters">
    Create meters and log readings from the Cloud BMS mobile app.
  </Card>
</CardGroup>
