---
title: "Set map styles and icons"
description: "Choose how network maps, diagrams, and exports draw each kind of link, widen faster links, set the drawing sheet, and add your own device icons."
url: "https://support.outpostplatform.com/network-maps/map-styles/"
product: "depot"
type: "how-to"
status: "draft"
ai_summary: "Network map style profiles in Outpost: Settings > Network maps holds the practice style (link color, width, and line per link class, line width by speed, drawing sheet options) and the icon library (PNG, WebP, or SVG up to 64 KiB, matched by model, vendor, or kind). On the MSP plan each client can override any field. Needs network_map:manage."
availability:
  plans: ["home-lab", "essentials", "enterprise", "msp"]
  permission: "network_map:manage"
  preview: false
source: "https://gitlab.com/outpostplatform/docs/-/edit/main/src/content/docs/network-maps/map-styles.md"
license: "CC BY 4.0"
---

# Set map styles and icons

A map style decides how every network map, documented diagram, and export
draws its links: the color, width, and line of each kind of link, and whether
faster links are drawn wider. It also sets what an exported drawing carries
around it, and which icon each device gets. Set it once for your organization.
On the MSP plan, a client can override any part of it, for example to match a
client's own cabling color code.

Outpost ships with defaults that follow common cabling conventions, so you
only need to change what your practice does differently.

## Before you begin

- Changing styles and icons needs `network_map:manage`. Anyone with
  `discovery:read` can see them.
- A change applies the next time a map is drawn or exported. Diagrams already
  saved keep the styles they were drawn with until you redraw them. See
  [Keep documented network diagrams](/network-maps/documented-diagrams/).

## Set your link styles

1. Go to **Settings** > **Network maps**.
2. Under **Link styles**, for each kind of link you want to change, set the
   **Color**, the **Width** (0.5 to 8), and the **Line**: **Solid**,
   **Dashed**, **Dotted**, or **Double**. **Preview** shows the result.
3. Select **Save**.

Each link gets one style, picked in this order: its media when Outpost knows
it, else its role, such as a trunk or a VPN, else whether it is physical or
logical. A link that is inferred or not seen recently is drawn dashed, and a
link not seen recently also takes that row's color. **Reset to defaults**
returns the link styles, speed widths, and sheet options to the shipped
defaults. Icons are not affected.

### The shipped defaults

| Link | Color | Line |
| --- | --- | --- |
| **Single-mode fiber** | Yellow, `#e6b400` | Solid |
| **Multimode fiber (OM1/OM2)** | Orange, `#f28c28` | Solid |
| **Multimode fiber (OM3/OM4)** | Aqua, `#12a4a8` | Solid |
| **Multimode fiber (OM5)** | Lime green, `#7dba2f` | Solid |
| **Copper** | Blue, `#2f6fd6` | Solid |
| **Direct attach copper** | Gray, `#6b6f73` | Solid |
| **Wireless** | Light gray, `#8a8f94` | Dotted |
| **Physical link (media unknown)** | Dark gray, `#555b61` | Solid |
| **WAN** | Dark gray, `#555b61`, width 2 | Solid |
| **VPN** | Purple, `#7a4fb0` | Dashed |
| **Trunk** | Dark gray, `#555b61` | Double |
| **Link aggregation** | Dark gray, `#555b61` | Solid |
| **Stack** | Near black, `#2b2f33`, width 3 | Solid |
| **HA sync** | Amber, `#b7791f` | Dotted |
| **Logical link** | Gray, `#6b6f73` | Dashed |
| **Depends on** | Gray, `#6b6f73`, with an arrow | Dotted |
| **Inferred link** | Dark gray, `#555b61` | Dashed |
| **Not seen recently** | Amber, `#b7791f` | Dashed |

Every width is 1.5 unless the table says otherwise. A link aggregation is
drawn 1 wider than its style says.

## Draw faster links wider

Under **Line width by speed**, **Draw faster links wider** is on by default.
A link whose speed Outpost knows is drawn at the width of the highest tier it
reaches, instead of its style's width:

| **From (Mbps)** | **Width** |
| --- | --- |
| 0 | 1 |
| 1000 | 1.5 |
| 10000 | 2.5 |
| 25000 | 3.5 |
| 100000 | 5 |

Change a tier's values, select **Add tier** or **Remove**, then select
**Save**. Turn the switch off to draw every link at its style's width.

## Set the drawing sheet

**Drawing sheet** sets what exported drawings carry around the drawing:

| Option | Effect |
| --- | --- |
| **Title block** | The client, site, view, title, author, date, revision, and "Generated by Outpost". Live map exports leave the author blank. |
| **Legend of the link styles used** | One row for each kind of link the drawing uses. It appears when a drawing uses two or more. |
| **Revision table on documented diagrams** | The last 10 revisions, with date, author, and note. |
| **Practice logo in the title block** | The **Logo** set under **Branding** in your sales settings, when you have one. |
| **Paper** | **Letter**, **Tabloid**, **A4**, or **A3**, for PDF exports. |
| **Orientation** | **Landscape** or **Portrait**, for PDF exports. |
| **Footer** | One line of text, up to 200 characters. |

Select **Save** when you are done.

## Override the style for one client

On the MSP plan, each client can have its own style. What it does not set
follows **Settings** > **Network maps**.

1. Go to **Clients** and open the client.
2. In **Network map style**, change the rows you want. A row the client has
   not changed shows **Inherited**.
3. Select **Save**.

Select **Reset** on a row to inherit it again, or **Use the practice style**
to clear the whole override.

## Add a device icon

Each device on a map is drawn with its kind's icon. Add your own to show a
vendor's logo or a specific model.

1. Under **Icons**, choose an **Image**: PNG, WebP, or SVG, at most 64 KiB
   and 512 by 512 pixels.
2. Enter a **Name**.
3. Choose what the icon is for. Set any of **Device kind**, **Vendor**, and
   **Model**. A device uses the icon only when everything you set matches it.
   Vendor and model match what discovery or SNMP reports for the device,
   ignoring case.
   With none set, the list shows **Only devices it is chosen for**, and the
   icon appears in the **Outpost devices** library of the
   [diagram editor](/network-maps/diagram-editor/) for you to place by hand.
4. Select **Add icon**.

When several icons match a device, it uses the first of: an icon chosen for
it in the diagram editor, then one matching its model, then its vendor, then
its kind. At each step a client's own icon comes before the practice's.

To add an icon for one client only, add it in the client's **Network map
style** panel instead. Practice icons are listed there with **Practice** and
can be deleted only from **Settings** > **Network maps**.

PNG and WebP icons are stored as PNG. An SVG icon is cleaned before it is
stored, and one holding scripts, links, embedded images, or references to
other files is refused with the reason. PNG and PDF exports draw an SVG icon
that uses only plain shapes and solid colors, and the device's kind icon
otherwise.

## Verify

Open **Endpoints** > **Network map** on the **Physical (L1)** view. Links
whose media Outpost knows follow your colors, faster links are wider, and
devices that match an icon show it.

## If something goes wrong

| Symptom | Fix |
| --- | --- |
| **Changing the style needs the network_map:manage permission.** | Ask an owner to add `network_map:manage` to your role. |
| Every link is the same gray | Outpost does not know the links' media. See [How media is worked out](/network-maps/link-details/#how-media-is-worked-out), or set it in the link's details. |
| A device does not use your icon | A field you set on the icon does not match the device. Check the device's vendor and model in its details on the map. |

## Next steps

- [Edit link details](/network-maps/link-details/)
- [Export network maps and diagrams](/network-maps/export/)