> ## 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. # System graphics > Create and interact with schematic diagrams of building systems with live data overlays in Cloud BMS. System graphics are a building-level feature. Select a building from the [sites list](/products/kode-os/sites-and-map) to access system graphics through the Systems module or Graphic Tool. System graphics are schematic or P\&ID-style visual diagrams of building systems with live data overlaid on equipment components. They provide a visual representation of how equipment is connected and operating, making it possible to monitor system health and diagnose issues at a glance. ## Use cases System graphics are commonly used for: * **AHU schematics** showing airflow paths, damper positions, fan speeds, and temperature readings * **Chiller plant diagrams** displaying chiller status, pump operation, and water temperatures * **Electrical one-line diagrams** with live power readings and breaker status * **Boiler system layouts** with supply and return temperatures, valve positions, and firing status ## Navigate to system graphics You can access system graphics from two entry points: * **Graphics module** -- click `Graphics` in the left sidebar and select the `Systems` tab to view existing system graphics * **Systems module** -- click `Systems` in the left sidebar, select a system, and switch to the Graphics view Graphics module showing the Systems tab with a System Floor graphic card for HWS, a search bar, and a New Graphic button ## Create a system graphic Before creating a system graphic, make sure you have [created a system](/products/kode-os/systems#create-a-system) in the Systems module. The graphic must be linked to an existing system. Navigate to `Graphics` in the left sidebar, select the `Systems` tab, and click `New Graphic`. You can also create a system graphic from within a system by navigating to the Graphics view and clicking `+ Create New`. Enter the graphic name, select the system to link it to, and add an optional description. You can also upload a system file (such as a P\&ID drawing) as a background by dragging and dropping or browsing for a file. New System Graphic dialog with fields for Graphic Name, System dropdown, Description, and a System File drag-and-drop upload area Enter a descriptive name for the system graphic (for example, `Hot Water System`). Select the system this graphic belongs to. The dropdown lists all systems configured in the [Systems module](/products/kode-os/systems#create-a-system). Add an optional description of the graphic's purpose. Upload a background image or P\&ID drawing. Drag and drop a file, click `Browse files` to upload from your computer, or click `Browse from files` to select from previously uploaded files. Click `Done` to create the graphic and open it in the [Graphic Tool](/products/kode-os/graphics/graphic-tool) editor. ## Build the system schematic The Graphic Tool editor provides three tabs for building system graphics: Devices, Elements, and Basics. ### Devices tab The `Devices` tab lists all devices and points associated with the linked system. A green checkmark with a number indicates how many points from that device are already placed on the graphic. Graphic Tool editor showing the Devices tab with a list of devices including AHU_1 through FCU_208, and a system piping schematic on the canvas Expand a device to see its points with current values. Drag a point onto the canvas to place a marker at the corresponding location on the schematic. Use the search, sort, and filter icons at the top of the device list to find specific devices or points. ### Marker style When you select a placed marker, the right panel displays style options for customizing its appearance. Graphic Tool showing FCU208 device expanded with point values on the left, system schematic with On status markers in the center, and marker style options including Alignment, Layout, Container, Borders, and Header on the right The marker style panel includes: * **Alignment** -- position the marker relative to other selected elements * **Layout** -- choose the display layout (Default, or horizontal/vertical alignment options) * **Container** -- set the fill color and choose rounded or square corners * **Borders** -- toggle border visibility and style * **Header** -- show or hide the device name header, set font size, and customize the header color For detailed marker configuration including smart markers and color-coded ranges, see the [Graphic Tool](/products/kode-os/graphics/graphic-tool#devices-tab) documentation. ### Elements tab The `Elements` tab displays reusable elements that have been saved to the graphic's element library. Use this tab to search, select, and style placed elements. Selecting an element from the list highlights it on the canvas and opens the Marker Style panel on the right. Graphic Tool showing the Elements tab with FCU208 entries and a table element listed, the system schematic on the canvas, and the Marker Style panel with Layout, Container, Borders, Header, and Pointer options ### Basics tab The `Basics` tab contains shapes, device widgets, uploads, and built-in drawings for constructing system schematics. Graphic Tool showing the Basics tab with Uploads section, and Drawings organized by category including North Sign, AHU Elements with Sensor and Fan subcategories, Cooling and Heating Coil, and Electrical Heater The `Drawings` section contains pre-built equipment components organized by category: * **North Sign** -- directional indicator * **AHU** -- air handling unit elements including sensors, fans, cooling and heating coils, and electrical heaters * Additional equipment categories for valves, pipes, pumps, and other system parts Drag and drop components onto the canvas to build the schematic. See the [Graphic Tool Basics tab](/products/kode-os/graphics/graphic-tool#basics-tab) for details on shapes, device widgets, and uploads. ## System layers Layers organize the system graphic into multiple views, reducing clutter on complex schematics. Click `+ Add Layer` at the bottom right of the canvas to create a new layer. Create Layer dialog with fields for Layer name, icon selector showing No icon selected, and an Import devices from another layer checkbox Enter a descriptive name for the layer. Select an icon to represent the layer in the layer selector bar. Copy device placements from an existing layer to use as a starting point for the new layer. * The **Base Layer** shows critical operating parameters * Additional layers contain supplementary data, tables, system markers linking to related systems, and diagnostic points Use [layer configurations](/products/kode-os/graphics/graphic-tool#settings) in the Graphic Tool settings to pre-map device types and points to layers. Dropping a device onto a layer with a configuration automatically adds the correct point marker. ## Overlays Overlays are additional visual layers that you can toggle on and off over the system graphic. Use overlays to display supplementary information such as duct routes, piping paths, or wiring diagrams without cluttering the main schematic. Click `+ Add Overlay` at the bottom right of the canvas to create an overlay. Graphic Tool showing the system schematic with the Base Layer selector, Add Layer, and Add Overlay options at the bottom of the canvas For more details on overlay configuration, see the [Graphic Tool overlays](/products/kode-os/graphics/graphic-tool#overlays) documentation. ## System markers System markers act as navigation links between system graphics. They allow users to jump between related schematics or navigate from a floor plan directly to a system graphic. While editing a graphic, switch from `Devices` to `Systems` in the left-hand elements menu. Drag and drop a system onto the canvas to create a clickable navigation marker. ## Read live data on a system graphic System graphics overlay real-time point values directly on the schematic: * **Temperature readings** near corresponding sensors * **Valve positions** as percentage values next to valve symbols * **Fan and pump status** indicators showing running, stopped, or fault states * **Pressure and flow readings** at their measurement locations ## Identify alarms and faults Devices and points on the system graphic use color-coded status indicators: | State | Indicator | Meaning | | -------------- | ----------- | -------------------------------------------------- | | **Alarm** | Red icon | Active alarm condition | | **Down** | Grey icon | Device or point is not communicating | | **Fault** | Orange icon | Fault condition detected | | **Stale** | Yellow icon | Value has not updated within the expected interval | | **Overridden** | Purple icon | Point is under manual override | Click any device on the graphic to open its details or access the command window for writable points. ### Command actions and priority levels Cloud BMS uses a BACnet-inspired priority model for writable points. The same command dialog appears for BACnet and non-BACnet integrations, such as REST API thermostats. How each action maps on the device depends on the connector. BACnet points that accept commands have **16 priority levels** (1 is highest, 16 is lowest). When every level is empty (`null`), the point uses a **fallback / default** value (`Relinquish_Default` in BACnet). That fallback is **not** a 17th BACnet priority. Some interfaces label it as level 17 for display only. `Override` and `Set` turn different knobs under the hood, even when the visible value looks the same. | Action | What it writes\* | Description | | ---------- | -------------------- | ------------------------------------------------------------------------------------------- | | `Override` | Priority 8\* | Temporary exception in the priority array. Takes precedence over lower-priority automation. | | `Set` | Fallback / default\* | Changes the fallback or default value. | | `Auto` | — | Clears an `Override` | | `Release` | — | Clears a `Set` | \*Typical for most BACnet and Niagara deployments. Connectors and site standards can differ. `Override`, `Auto`, and `Set` borrow Niagara-style action names. `Release` is a Cloud BMS action that clears a `Set`. In Niagara-style control, `Set` keeps a non-null fallback so sequences and logic keep a reliable baseline. Use the priority array (including `Override`) for programmed automation and temporary exceptions. To make `Set` write to priority 16 instead of the fallback or default, enable **`Set in Slot16`** (Niagara) on the point. Configure that option from [device details](/products/kode-os/devices/devices#view-and-edit-points), [device templates](/products/kode-os/devices/device-templates), or [points batch update](/products/kode-os/points/points-batch-update). ## Delete a system graphic To remove a system graphic, click the three-dot menu on the graphic card in the Systems list and select `Delete`. Graphics module Systems tab showing two system graphic cards with a three-dot menu expanded on Hot Water System showing Edit and Delete options Confirm the deletion when prompted by clicking `Yes, delete`. Delete Graphic confirmation dialog with Cancel and Yes delete buttons Deleting a system graphic removes the visual layout and marker configuration. The devices and points themselves are not affected. ## Next steps Configure smart markers, zones, layers, and global settings. Build equipment-level visuals with live point data.