Add the GitLab cards to your dashboard

The GitLab cards of My Dashboards show what your own GitLab account sees. You add a card, then you connect your account from the card itself, once.

Before you start

• Your administrator has added the GitLab integration. Without it, the gitlab source is not in the list.
• You have a GitLab token of your own.

➕ 1. Add a card

1. In the left sidebar, click My Dashboards, then the tab of the dashboard you want.

2. Click Add a card, at the top of the page.

3. In Add a card, pick the Source gitlab, then a Key:

   Key	What it shows
   Pipelines	The last pipeline of each branch of your active projects, when it failed or ran lately
   Detailed Pipelines	The jobs of your latest pipelines, with status and duration
   Merge Requests	Merge requests of every GitLab project of the catalog that your token can read, with status and your role (filter on it for your own)
   Releases	The last published release of each GitLab project of the catalog your token can read
   To-Do List	Your pending GitLab to-dos: reviews requested, assignments, mentions, broken builds

4. Enter a Card Name, then click Add.

🔑 2. Connect your GitLab account, in the card

The first time, the card says Your GitLab account is not connected.

1. In the card, click Connect my GitLab account. The Connect my GitLab account window opens. It says where to create the token and with which rights (read_api and read_repository), and links to the token page of your GitLab.

2. Fill in:

   Field	What to enter	Example
   Username	Your GitLab username, the one after the @ on your GitLab profile. Astrolabe recognises you by it in GitLab events.	jdoe
   Token	The token of your own GitLab account, pasted as is	glpat-…

3. Click Test Connection. The window says Connection works: the tool accepted your token.

4. Click Save. The window closes and every GitLab card of your dashboard reads again.

✅ That's it!

Change or remove your token

Your GitLab account is listed in My Account › My accounts (your avatar, top right, then My Account, then the My accounts tab). Click Configure on the GitLab card to replace the token, or Delete to remove it.

The states in My Account › My accounts

State	What it means
Connected	You saved a token
Not connected	You have not saved a token
Token refused	GitLab refuses your saved token. Click Configure: the window says why.

Next: What each GitLab card shows.