ContextQMD
Back to Gitlabhq

Tutorial: Use the personal homepage

doc/tutorials/personal_homepage/_index.md

18.11.24.5 KB
Original Source

{{< details >}}

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

{{< history >}}

{{< /history >}}

<!-- vale gitlab_base.FutureTense = NO -->

The personal homepage consolidates all information relevant to you in one place. You can quickly identify new work items that need your attention, or pick up where you left off.

Follow this tutorial to learn how to find your way around the homepage, and to get the most out of it.

Before you begin

Set the personal homepage as the default homepage in your preferences.

Access the homepage

You can access your personal homepage from anywhere in GitLab:

  • In the left sidebar, at the top, select Homepage.
  • In the top bar, select Search or go to, select Your work, then select Home.

Layout of the homepage

Near the top, select your avatar to set your status. If you have set a status, your avatar displays a status badge and emoji, and you can hover to view your status text.

Below your avatar, view the number of merge requests and issues that you're involved with.

The Items that need your attention list shows all work items across GitLab that need your input.

The Follow the latest updates feed shows your activity across GitLab, and the activity of specific projects and users you're interested in.

Go to the right side of the homepage to access quick links to items you've recently viewed and projects you frequently visit.

Use the homepage to start your day

Let's go over a few ways you can use the homepage to get started with your work for the day:

  1. Use the filter in the Items that need your attention list to view the events that are most important to you. For example, to see merge requests that are blocked because of failed pipelines, select Failed builds from the filter dropdown list.
  2. Near the top of the homepage, select Merge requests waiting for your review to view the merge requests that need your review, so you can unblock others.

You can also keep track of what you have been working on, for example:

  1. In the Follow the latest updates section, use the Your activity filter to see your recent work. Select the links to go directly to the issue or merge request, and pick up where you left off.
  2. In the Quick access widget on the right:
    • Select Recently viewed to see issues, merge requests, and epics you recently visited.
    • Select Projects to see projects you frequently visit and starred projects.
      • To filter by project type, select Display options ({{< icon name="preferences" >}}).
    • Select any link to quickly return to items you were working on.

Stay connected with team activity

If you're collaborating in a project, add a star to the project to make it easier to find in future. Then, use the homepage to get an overview of what's happening in that project.

To add a star to a project and view its activity on the homepage:

  1. In the top bar, select Search or go to and find your project.
  2. In the upper-right corner of the page, select Star ({{< icon name="star" >}}).
  3. In the left sidebar, at the top, select Homepage.
  4. In the Follow the latest updates section, select Starred projects from the dropdown list.

To collaborate more effectively with your team, you can follow other GitLab users and see what they're working on:

  1. Go to the user's profile in GitLab, for example, https://gitlab.example.com/username, and select Follow. Alternatively, select Follow in the small popover that appears when you hover over their name anywhere in GitLab.
  2. In the left sidebar, at the top, select Homepage.
  3. In the Follow the latest updates section, select Followed users from the dropdown list.

Learn more about the different work items you can view and access from the homepage.