Projects

{{< details >}}

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

{{< /details >}}

Query fields

The following fields are required: Namespace

Field	Name (and alias)	Operators
Archived only	archivedOnly	=, !=
Group / Namespace	namespace, group	=
Has code coverage	hasCodeCoverage	=, !=
Has vulnerabilities	hasVulnerabilities	=, !=
Include archived	includeArchived	=, !=
Include subgroups	includeSubgroups	=, !=
Issues enabled	issuesEnabled	=, !=
Merge requests enabled	mergeRequestsEnabled	=, !=

Archived only {#project-archived-only}

Description: Filter to show only archived projects.

Allowed value types: Boolean (either true or false)

Notes:

• Cannot be used together with includeArchived.

Group / Namespace {#project-group}

Description: Specify the group namespace to query projects from. This field is required. You can use either namespace or group as the field name.

Allowed value types: String

Has code coverage {#project-has-code-coverage}

Description: Filter projects by whether they have code coverage reports.

Allowed value types: Boolean (either true or false)

Has vulnerabilities {#project-has-vulnerabilities}

Description: Filter projects by whether they have security vulnerabilities.

Allowed value types: Boolean (either true or false)

Include archived {#project-include-archived}

Description: Include archived projects in the results.

Allowed value types: Boolean (either true or false)

Notes:

• Cannot be used together with archivedOnly.
• By default, archived projects are not included.

Include subgroups {#project-include-subgroups}

Description: Whether to include projects from subgroups.

Allowed value types: Boolean (either true or false)

Notes:

• This field can only be used with the namespace or group field.
• Defaults to true when a namespace or group is specified.

Issues enabled {#project-issues-enabled}

Description: Filter projects by whether they have issues enabled.

Allowed value types: Boolean (either true or false)

Merge requests enabled {#project-merge-requests-enabled}

Description: Filter projects by whether they have merge requests enabled.

Allowed value types: Boolean (either true or false)

Display fields

Field	Name (and alias)	Description
Archived	archived	Display whether the project is archived
Duo features enabled	duoFeaturesEnabled	Display whether Duo features are enabled
Forked	forked	Display whether the project is a fork
Forks count	forksCount	Display the number of forks
Full path	fullPath	Display the full path of the project
Group	group	Display the group the project belongs to
ID	id	Display the project ID
Issues enabled	issuesEnabled	Display whether issues are enabled
Last activity	lastActivity, lastActivityAt	Display when the project was last active
Merge requests enabled	mergeRequestsEnabled	Display whether merge requests are enabled
Name	name	Display the project name
Open issues count	openIssuesCount	Display the number of open issues
Open merge requests count	openMergeRequestsCount	Display the number of open merge requests
Path	path	Display the project path
Secret push protection enabled	secretPushProtectionEnabled	Display whether secret push protection is enabled
Star count	starCount	Display the number of stars
Visibility	visibility	Display the project visibility level
Web URL	webUrl	Display the web URL of the project

Sort fields

Field	Name (and alias)	Description
Full path	fullPath	Sort by full path
Last activity	lastActivity, lastActivityAt	Sort by last activity date
Path	path	Sort by path

Notes:

• lastActivity only supports descending (desc) sort order.

Examples:

• List all projects in the gitlab-org group sorted by path:

  yamlCopy

  ```glql
  display: table
  fields: name, fullPath, starCount, openIssuesCount
  sort: path asc
  query: type = Project and group = "gitlab-org"
  ```
  

• List all projects in the gitlab-org group sorted by most recently active:

  yamlCopy

  ```glql
  display: table
  fields: name, fullPath, lastActivity
  sort: lastActivity desc
  query: type = Project and group = "gitlab-org"
  ```