# Retrieving projects

You can view any public project. You can view private projects for which you have the Browse permission.

## Using the Search box <a href="#search-box" id="search-box"></a>

1. In the top navigation bar, select the magnifier icon. The **Search for projects…** box is displayed along with a list of pre-selected projects.\
   Alternatively, press **S**.
2. You can enter a part of the project name in the box to filter the search.
3. Select the project in the list.

## Using the Projects page <a href="#projects-page" id="projects-page"></a>

1. In the top navigation bar, select **Projects**.
2. You can apply a search filter.
3. Select a project in the list of projects.

## Viewing your administered projects <a href="#administered-projects" id="administered-projects"></a>

To view the projects you’re administering:

1. Select your account menu in the top right corner of the SonarQube Server interface.
2. In the menu, select **My Account**.
3. Select the **Projects** tab.
4. Select a project.

## Retrieving your favorite projects <a href="#favorite-projects" id="favorite-projects"></a>

Favorite projects are marked with a yellow star.

To retrieve your favorite projects:

1. In the top navigation bar, select **Projects**.
2. In the top left corner, select **My Favorites**. Your favorite projects are listed on the page.

## Marking a project as favorite <a href="#marking-as-favorite" id="marking-as-favorite"></a>

To mark a project as a favorite:

1. [retrieving-projects](https://docs.sonarsource.com/sonarqube-server/10.8/user-guide/viewing-projects/retrieving-projects "mention").
2. In the top left corner, select the star.

![](https://312504542-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiJj3TXBdWssTGGg8qK5I%2Fuploads%2Fgit-blob-29a24559b3c26d63ffc639cf2b3ace4892ac9385%2Fa7df0d322b83999eed31d2f4b5db3b75c5fe7b7c.png?alt=media)

Alternatively, you can select or unselect the star in front of a project listed on the **Projects** page.

## Related pages <a href="#related-pages" id="related-pages"></a>

* [project-overview](https://docs.sonarsource.com/sonarqube-server/10.8/user-guide/viewing-projects/project-overview "mention")
* [activity-and-history](https://docs.sonarsource.com/sonarqube-server/10.8/user-guide/viewing-projects/activity-and-history "mention")
* [viewing-project-structure](https://docs.sonarsource.com/sonarqube-server/10.8/user-guide/viewing-projects/viewing-project-structure "mention")
* [managing-tokens](https://docs.sonarsource.com/sonarqube-server/10.8/user-guide/managing-tokens "mention")
* [project-badge](https://docs.sonarsource.com/sonarqube-server/10.8/user-guide/project-badge "mention")
* [subscribing-to-notifications](https://docs.sonarsource.com/sonarqube-server/10.8/user-guide/managing-your-account/subscribing-to-notifications "mention")
* [introduction](https://docs.sonarsource.com/sonarqube-server/10.8/user-guide/issues/introduction "mention")
* [security-hotspots](https://docs.sonarsource.com/sonarqube-server/10.8/user-guide/security-hotspots "mention")


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sonarsource.com/sonarqube-server/10.8/user-guide/viewing-projects/retrieving-projects.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.