Custom Types & Fields
Create custom device, cable, route, and zone types tailored to your organization's infrastructure.
Overview
Atlas comes with 16 built-in device types (Access Point, Camera, Switch, IDF Cabinet, Server Rack, UPS, and more) along with 5 cable types, 1 route type, and 2 zone types. On the Professional plan, you can extend these with your own custom types — each with custom names, colors, fields, icons, and categories.
Custom types are managed from the Custom Types panel inside Settings. The panel has four tabs: Devices, Cables, Routes, and Zones.
Custom Device Types
Creating a Device Type
- Open Settings and go to the Custom Types panel.
- On the Devices tab, click + Add.
- Enter a name for the type (e.g., "Badge Reader", "Digital Signage").
- Choose a marker color using the color picker. This color will be used for the marker on the map.
- Select an icon from the built-in icon library, or upload your own custom SVG.
- Choose a category to organize the type in the sidebar and type pickers.
- Add fields to define what data is tracked for devices of this type (see Field Types below).
- Click Save.
Editing a Device Type
Click the Edit button next to any custom device type in the list. You can change the name, color, icon, category, and fields. Changes to the type definition apply to all existing devices of that type.
Deleting a Device Type
Click the Delete button on a custom device type. You will be warned if any devices of this type exist on your maps. Deleting the type does not remove placed devices, but they will become orphaned and may not display correctly.
Custom Cable Types
Custom cable types let you represent cabling beyond the built-in categories (Cat5e, Cat6, Cat6a, Fiber SM, Fiber MM).
Creating a Cable Type
On the Cables tab in Custom Types, click + Add. Enter a name and select a color. Custom cables are drawn and behave the same way as built-in cable types.
Custom Route & Zone Types
The Routes and Zones tabs let you define additional route and zone types beyond the built-in options (Evacuation Route, Rendezvous Zone, and Construction Zone).
For route types, enter a name and color. For zone types, enter a name and color. Both behave identically to the built-in types but with your custom branding.
Field Types
When creating or editing a custom device type, you build its field list from the following available field types:
| Field Type | Description |
|---|---|
| Name | A special text field that sets the device's display name. Appears in the detail panel title and as a tooltip on the map marker. Only one per type. |
| Text | A general-purpose single-line text input. Use for serial numbers, room numbers, notes, or any freeform text. |
| Dropdown | A single-select dropdown with predefined options. You define the options when building the type. |
| IP Address | A validated input that accepts IPv4 addresses, IPv6 addresses, or hostnames. Invalid input shows a red border and error message. |
| Model | Renders as a text input on Standard tier. On Professional tier with models configured, renders as a dropdown of predefined model names (see Model Management). |
| Attached Switch | A dropdown listing all switches on the current site (standalone and embedded in containers). Use for documenting which switch a device is patched into. |
| Embedded Device | Links another device type as an embeddable component inside a container type. The embedded device uses the same fields as its standalone counterpart. |
Icon Library
Atlas includes a library of 27 built-in SVG icons covering common IT infrastructure and safety equipment. When creating or editing a device type, click the icon selector to open the icon picker modal.
The icon picker displays a grid of all available icons. Hover over any icon to see its name. The first option is "Upload Custom SVG", which lets you upload your own icon file.
Custom SVG Icons
Upload any SVG file as a custom icon. For best results, use a simple, single-color SVG designed at roughly 24x24px. The icon will be rendered as a white silhouette on the colored marker background using CSS masking.
Custom Categories
Categories organize types within the Custom Types panel and in the sidebar. Atlas has two built-in categories: Tech / IT and Safety.
On the Professional plan, you can create custom categories scoped to devices, cables, routes, or zones. This is useful when you have many custom types and want to group them logically (e.g., "Audio/Visual", "Access Control", "Environmental Sensors").
Editing Default Types
All 16 built-in device types appear in the Devices tab under a "Default Types" section. While you cannot change their built-in fields, you can extend them.
Adding Extra Fields
Click Edit on any default type to open the Default Type Editor. The built-in fields are shown as read-only. Below them, you can add extra fields — additional custom fields that will appear on every device of that type.
Static Fields
Extra fields can be marked as Static with a pre-filled value. Static fields render as read-only on all devices and are useful for organization-wide constants like "District Name" or "Department".
Model Management
Each device type (built-in or custom) can have a list of predefined model names. When models are configured, the Model field on devices of that type renders as a dropdown instead of a freeform text input.
Managing Models
In the Custom Types panel, click the Models (N) button on any device type. The Models panel opens, showing the current list of models as chips. Type a model name and press Enter to add it. Click the X on any chip to remove it.
Models are saved independently from the type's field definitions and are stored per-organization.