Features

An overview of the app's key features.

GitLab for Miro brings your GitLab work items onto your Miro boards as interactive App Cards. From there, you can edit work item fields, sync changes back to GitLab, and create new work items without ever leaving the board.

The app lives in a side panel inside Miro. You open it from the installed app icon in the left toolbar.

Everything: connections, linked projects, work item groups, sync controls, is found in the panel.

A description of the connections needed to use the app.

A connection is your authenticated link to a GitLab instance. Connections are per-user and available across all your Miro boards; you connect once, and all your boards can use it.

You can connect to:

• GitLab Cloud (gitlab.com) via OAuth

• Self-managed/On-prem GitLab via OAuth application or Personal Access Token (PAT)

You can hold multiple connections at once — for example, gitlab.com and a self-managed instance simultaneously. For self-managed OAuth, a team admin registers a single OAuth application for the whole Miro team; each individual then authorizes their own account.

Information on linking projects to the app.

Project linking pulls all work items from an entire GitLab project onto your board in one step, applying the filters you define.

When you link a project, you choose:

• Which GitLab project to import

• Filter criteria — work item state (open/closed/all), labels, milestone, assignee, and a text search

• Which fields to show on each card (title, assignee, labels, milestone, and more)

Linked projects are board-specific, meaning the same project can be linked on different boards with different filter sets. A single card sync brings in all matching work items as App Cards.

A description of Work Item groups that can be used in the app.

A work item group is a curated collection of specific items, assembled by search rather than pulled from a single project. You can use groups when you need work items from multiple projects on one board, or when you only want a subset of a project's work items without importing the entire project.

You build a group by searching for work items — across one project or all projects on a connection — then picking which ones to add. The group lives on the board as its own section, with its own Sync button and card color.

Work item groups and linked projects count toward the same project limit on your plan.

Information about converting sticky notes to app cards.

During workshops, you often end up with sticky notes representing work items. Sticky note conversion turns those notes into real GitLab work items in bulk, without retyping.

Select one or more stickies on the board, open the Add work items menu, and choose Convert Sticky Notes. You pick a connection, target project, and optional shared metadata (labels, milestones, assignees) to apply to all converted work items. Each sticky note's text becomes the work item title. After conversion, the stickies are replaced by App Cards.

The converted work items are saved as a work item group on your board.

A description of App Cards.

Work items appear on the board as app cards — Miro's native card type for connected app data.Each card shows:

• Work item title

• GitLab status (open, closed, etc.)

• Assignee

• Labels

• Milestone

You can toggle which fields are shown when you link a project. Cards are color-coded by project or work item group; the color is randomly assigned when you link and can be changed at any time.

Information on editing App Cards and how those edits sync with GitLab.

Double-click any App Card to open the Edit modal. From there, you can edit:

• Title

• Status (GitLab state)

• Assignee

• Labels

• Milestone

• Description

Edits are saved back to GitLab immediately when you close the modal, with no separate save step.

The modal also shows:

• Work item links: Relationships such as relates to, blocks, and is blocked by. You can remove links from within Miro.

• Epic breadcrumb: If the item belongs to a GitLab Epic (Premium/Ultimate), a link to the Epic appears at the top of the modal.

Syncing from GitLab to Miro is a manual process. Changes made in GitLab (by you or teammates) do not appear on your board until you click Sync on a project card or Sync All in the main header. This keeps your board stable during live sessions.

Information on creating Work Items in Miro.

You can create a new GitLab work item directly from the panel without switching to GitLab. Click Create Work Item in the action bar, pick a connection and project, fill in the title and optional fields (description, labels, milestone, assignee, due date, weight), and submit.

The new item appears as an App Card on the current board.

Information on deleting and recovering App Cards.

If you delete an App Card from the Miro board, the app asks whether you want to stop tracking the work item or recover the card.

• Recover: Recreates the card with full fidelity and re-links it. This is the default if you dismiss the dialog without making a choice.

• Stop tracking: Removes the card from the app's tracking. The underlying GitLab work item is not affected.

Accidentally stopped tracking? You can re-add the work item at any time via Search.

Information on the color of App Cards and how to make changes.

Each project link and work item group has a color applied to all its cards. Colors are randomly assigned when you first link a project or create a group. You can change the color at any time using the color picker on the project or group card in the panel.

Color changes do not trigger a GitLab sync; they are a local visual setting.