How to add a label in Linear on Mac: steps for the desktop app

Labels are small tags you attach to issues in Linear. They help you sort, group and filter work, so a bug report does not get lost next to a feature request. On a Mac, you can add one in a few seconds once you know where the controls are. This page covers the desktop app, the L shortcut, the Labels field, and the rules that decide how many labels one issue can carry.

Desktop app or browser: which one you use

Linear runs in two places. The Linear Desktop app for macOS supports both Intel and Apple silicon Macs, and it updates itself in the background. The web app runs in a browser and supports the three most recent versions of Chrome, Firefox and Safari.

The desktop app adds OS notifications and a Dock unread indicator. Its keyboard shortcuts also clash less with browser shortcuts. That matters for a single key like L, because a browser can grab it first.

The sources I could open do not list a minimum macOS version or an app version number for labels. If your Linear window looks different from the steps here, check for an app update before you assume the steps are wrong.

Add a label with the L shortcut

The fastest route is the L key. Select an issue in the list or on the board, press L, and the label picker opens. Type part of a label name to narrow the list, then press Return on the label you want.

The L shortcut comes from a third-party shortcut sheet, not from Linear's own help pages. Press ? inside Linear to see the shortcut list for your version before you rely on it.

1. Select the issue in the list or on the board.
2. Press L to open the label picker.
3. Type part of the name to filter the list.
4. Press Return on the label you want, then press Esc to close the picker.

Add a label from the Labels field

If you prefer the mouse, open the issue first. In the right sidebar, click the Labels field. The same picker opens, and you can scroll the full list when you are not sure of the exact name.

Use the mouse when you are browsing. Use L when you already know the name and want to move fast through a backlog.

A link such as linear.new?labels=bug,android,comments opens a new issue with those labels already set. Linear's issue docs describe this pre-fill. It runs in a browser, so use it when you want the same setup for several issues or a teammate.

Create a label that does not exist yet

If the label is missing, create it in label settings rather than on the issue. Settings paths differ between sources. Linear's project labels doc says workspace labels live under Settings > Projects > Labels, and team labels live in each team's own settings. Other sources say Settings > Workspace > Labels.

Linear's own labels article did not open when this page was checked. Trust the path you see in your app over any page, including this one.

What to fill in when you create a label

Give the label a short name that a teammate can scan in a list. Pick a color that sets it apart from the others. Then choose the group it belongs to.

Names cannot include emojis. Linear made this change on Sep 3, 2026, so type a plain word or a short phrase instead of a symbol. A name like Bug works. A name with a face or a flag does not.

Single-select and multi-select label groups

Every label belongs to a group. Groups default to single-select, which means an issue can carry only one label from that group. Linear added a multi-select option on Oct 22, 2026.

To change the type, open the label's contextual menu and find Group type. Choose single-select or multi-select. The change decides how many labels from that group one issue can hold.

Here is a worked example. Say you have a group called Area with two labels, Frontend and Backend. While Frontend is on an issue, a single-select group blocks Backend. Remove Frontend, then add Backend.

If the issue really touches both areas, change the group to multi-select. Then both labels can sit on the issue together. Decide this before your team starts tagging, because changing the type later affects every issue that already has labels from the group.

On Nov 5, 2026, Linear changed how label menus show a multi-select group. Each selected label now gets its own row in the menu. In web forms, selected labels show as removable chips, so expect that layout if your team uses multi-select groups.

Filter issues by the labels you add

A label only helps when you can find it later. On Sep 14, 2026, Linear made new label filters default to include any of when every selected label belongs to the same group.

On Sep 3, 2026, Linear added a No labels filter option. Use it to catch issues that still need tagging. For the full filter steps, read how to filter issues in Linear on Mac.

What happens when you move an issue to another team

Team labels stay with their team. When you move an issue to another team, Linear removes its team labels. Create the label in the new team first, then move the issue and add the label again.

Troubleshooting when a label will not add

Most label problems come from one of four causes. Work through them in order, because the first two are the most common.

• The second label is blocked, because the group is single-select.
• The label is missing, because it belongs to another team.
• The L key does nothing, because the cursor sits in a text field.
• The name is rejected, because it contains an emoji.

If none of those fit, update the desktop app and try again. The app updates itself in the background, but admins can turn that off, so ask an admin if updates never arrive.

Mistakes people make with labels on Mac

The same few mistakes show up in most teams. They are easy to avoid once you see them, and each one costs time later.

• Creating a near-duplicate label. Type the name in the picker first, and check whether a close match already exists.
• Using a single-select group for a value that really needs two answers.
• Forgetting that team labels do not follow an issue to another team.
• Pressing L while the cursor is in a title box. That types the letter instead of opening the picker.
• Adding emojis to label names, which Linear no longer allows.

The fix for most of these is a quick review. Once a month, scan the label list, remove duplicates, and check which groups should allow more than one value.

Next steps after you tag issues

Once labels sit on your issues, you can build views that show only the work you care about. Read how to switch between list and board in Linear on Mac to choose the layout that shows labels best.

When you need to work through a batch, select multiple issues in Linear on Mac and review them in one pass. Tagging goes faster when you already know which issues need which labels.

Where Lazur helps with labels on Mac

Lazur is a voice assistant for the Mac. Hold Option and Command, then ask about what is on your screen. Ask where the Labels field is, and Lazur draws a circle and a label around it.

Ask for a walkthrough, and Lazur guides you one click at a time. It waits for each click before it moves on, so you stay in control of Linear. Lazur does not click for you, and it does not add the label, create the group or change team settings.

Lazur works in any app on screen. The same question works when you switch to a different tool, so you do not need to learn a new help menu for each one. Read Lazur for Linear on Mac to see what it covers, or download Lazur to try it on your Mac.

Keep your label list tidy

Labels pile up fast. Every new team member adds one, and soon you have three names for the same thing. A short review keeps the picker useful, so people trust the list and stop inventing new names.

Start with the labels that appear on the most issues. Rename the vague ones, remove the duplicates, and set group types so the rules match how your team works.