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

# Customize the menu bar display

> Choose what the WiFi Signal Pro menu bar item shows, using values, text, and styling.

The *WiFi Signal Pro* item in the menu bar can show a signal strength indicator, the access point's vendor icon, and up to two lines of text. By default, it shows the signal strength indicator and the network name. The indicator's bars follow the signal-to-noise ratio (SNR), using the levels in [Monitor signal quality](https://docs.intuitibits.com/wifisignalpro/monitor-signal-quality.md#meter).

When your Mac isn't connected to Wi-Fi, the bars are unlit. When Wi-Fi is turned off, a slash crosses the bars. Custom text and the vendor icon appear only while your Mac has a Wi-Fi connection; otherwise, the indicator keeps the app visible in the menu bar.

Each line of text is built from *values*, such as the network name, the channel, or the signal strength, and any text you type around them. *WiFi Signal Pro* replaces each value with the current reading. When you use two lines, *WiFi Signal Pro* adjusts the font size so both fit.

## Set up the menu bar display

1. Click the *WiFi Signal Pro* item in the menu bar, then click the *gear* icon.
2. Click **Menu Bar**.
3. Click in **Line 1** or **Line 2**.
4. Click a value in the list below to insert it, or drag it into place. Type any text you want around the values.

The preview at the top of the pane shows the item as it will appear in the menu bar. If your Mac isn't connected to a Wi-Fi network, the preview uses example values.

![Menu Bar settings, with the Label value on line 1 and the Signal and Channel values on line 2](https://mintcdn.com/intuitibits/cQ6XgEmjYTKhko5_/images/wifisignalpro/settings-menu-bar.png?fit=max\&auto=format\&n=cQ6XgEmjYTKhko5_\&q=85\&s=60a0923a7dcdfa6c2bbd542647defd2d)

Line 1 shows the label in bold; line 2 shows the signal strength and channel with text around them.

### Style text

Select text or values in a line and press **Command-B** for bold or **Command-I** for italic. You can also Control-click a selection and choose **Bold** or **Italic**.

### Show part of a value

For values such as the network name, BSSID, AP name, label, vendor, and addresses, you can show just part of the value, for example the last three octets of a BSSID.

1. Click the arrow on the value in the line, or Control-click the value and choose **Edit Value…**
2. Drag across the characters you want to keep.

To show the whole value again, click **Use whole value**.

### Show something else when a value is unavailable

Some values aren't available on every network. Many access points don't advertise a name, for example, an access point has no label until you give it one, and for a few seconds after your Mac moves to another access point there's no transmit rate. By default, *WiFi Signal Pro* leaves an unavailable value out of the line. You can instead choose what to show in its place.

1. Click the arrow on the value in the line, or Control-click the value and choose **Edit Value…**
2. Under **If unavailable, show**, click **Add** and choose another value, or choose **Text** and type the text to show, such as `—`.
3. Add more values if you want. *WiFi Signal Pro* shows the first one in the list that's available. Drag a row by its handle to change the order, or click the *minus* icon to remove it.

Each row shows that value's current reading, so you can see what the line would show if the value were unavailable. To show part of a value in the list, click it and drag across the characters you want to keep. Text is always available, so anything listed after it is never used.

In the line, the value names the first alternative and counts the rest, for example *AP Name or Label +1*.

> [!NOTE]
>
> Values that every reading has, such as the network name, BSSID, channel, and signal, don't offer this option.

***

## Values

| Group | Value | Code |
| - | - | - |
| Network | Network Name | `%N` |
| Network | BSSID | `%B` |
| Network | AP Name | `%A` |
| Network | Label | `%L` |
| Network | Vendor | `%V` |
| Network | Security | `%K` |
| Network | Internet | `%O` |
| Radio | Channel | `%C` |
| Radio | Width | `%W` |
| Radio | Band | `%F` |
| Radio | Mode | `%P` |
| Radio | Generation | `%G` |
| Signal | Signal | `%S` |
| Signal | Noise | `%D` |
| Signal | SNR | `%R` |
| Signal | MCS Index | `%M` |
| Signal | Transmit Rate | `%T` |
| Signal | Maximum Transmit Rate | `%X` |
| Signal | Spatial Streams | `%H` |
| Signal | Channel Utilization | `%U` |
| Addresses | IPv4 Address | `%I` |
| Addresses | IPv6 Address | `%J` |
| Addresses | IPv4 Router | `%Y` |
| Addresses | IPv6 Router | `%Z` |

Values are shown without units, so add the units you want as text, for example `%S dBm`.

> [!NOTE]
>
> **Channel Utilization** is empty unless *WiFi Signal Pro Extended Metrics* is installed. See [Measure channel utilization](https://docs.intuitibits.com/wifisignalpro/measure-channel-utilization.md). **Maximum Transmit Rate** is the highest transmit rate this connection can reach as it stands, given its generation, band, channel width, and spatial streams, and is empty when that isn't known.

***

## Edit codes directly

If you prefer to type, select **Show placeholder codes instead of names**. Each line then shows the codes from the table above as plain text.

* To make text bold, surround it with `**`. To make it italic, surround it with `_`.
* To show part of a value, add `[start:stop]` after its code, where `start` is the zero-based index of the first character and `stop` is the index after the last one. Leave out `start` to begin at the first character, or `stop` to continue to the end. Negative numbers count from the end.
* To show something else when a value is unavailable, add the alternatives in braces after its code and any `[start:stop]`, separated by `|`. Each alternative can have its own `[start:stop]`. The first one that's available is shown. For example, `%A{%L|%B[-5:]|—}` shows the AP name, or else the label, or else the last five characters of the BSSID, or else `—`.

### Examples

| Line | Result |
| - | - |
| `%N \| Ch %C, %W MHz` | `Conference Room \| Ch 44, 80 MHz` |
| `**%L** %S dBm` | **Lobby** `-52 dBm` |
| `%B[-8:] %S dBm` | `34:62:10 -52 dBm` |
| `%T of %X Mbps` | `960 of 1200 Mbps` |
| `%A[0:8]{%L\|%B[-5:]}` | `Kitchen` (the label, if the access point doesn't advertise a name) |

## See also

* [Menu Bar settings](https://docs.intuitibits.com/wifisignalpro/menu-bar-settings.md)
* [Use labels](https://docs.intuitibits.com/wifisignalpro/use-labels.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.