2020-07-28 14:09:36 -04:00
---
stage: Create
group: Source Code
2020-11-26 01:09:20 -05:00
info: "To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments"
2020-07-28 14:09:36 -04:00
type: reference
---
2021-02-09 13:09:59 -05:00
# Projects **(FREE)**
2017-07-31 05:44:07 -04:00
2021-02-10 13:09:02 -05:00
In GitLab, you can create projects to host
your codebase. You can also use projects to track issues, plan work,
collaborate on code, and continuously build, test, and use
built-in CI/CD to deploy your app.
2017-07-31 05:44:07 -04:00
2021-02-10 13:09:02 -05:00
Projects can be available [publicly, internally, or privately ](../../public_access/public_access.md ).
GitLab does not limit the number of private projects you can create.
2017-07-31 05:44:07 -04:00
2018-12-13 14:26:56 -05:00
## Project features
2017-07-31 05:44:07 -04:00
2021-02-09 04:09:19 -05:00
Projects include the following [features ](https://about.gitlab.com/features/ ):
2017-07-31 05:44:07 -04:00
2019-05-05 11:37:18 -04:00
**Repositories:**
2017-07-31 05:44:07 -04:00
2021-02-10 13:09:02 -05:00
- [Issue tracker ](issues/index.md ): Discuss implementations with your team.
- [Issue Boards ](issue_board.md ): Organize and prioritize your workflow.
- [Multiple Issue Boards ](issue_board.md#multiple-issue-boards ): Create team-specific workflows (Issue Boards) for a project.
- [Repositories ](repository/index.md ): Host your code in a fully-integrated platform.
- [Branches ](repository/branches/index.md ): Use Git branching strategies to
collaborate on code.
2017-07-31 05:44:07 -04:00
- [Protected branches ](protected_branches.md ): Prevent collaborators
2021-02-10 13:09:02 -05:00
from changing history or pushing code without review.
- [Protected tags ](protected_tags.md ): Control who has
permission to create tags and prevent accidental updates or deletions.
2019-10-27 02:06:30 -04:00
- [Repository mirroring ](repository/repository_mirroring.md )
2021-02-10 13:09:02 -05:00
- [Signing commits ](repository/gpg_signed_commits/index.md ): Use GNU Privacy Guard (GPG) to sign your commits.
- [Deploy tokens ](deploy_tokens/index.md ): Manage access to the repository and Container Registry.
2019-05-05 11:37:18 -04:00
- [Web IDE ](web_ide/index.md )
2020-09-11 20:08:44 -04:00
- [CVE ID Requests ](../application_security/cve_id_request.md ): Request a CVE identifier to track a
vulnerability in your project.
2019-05-05 11:37:18 -04:00
**Issues and merge requests:**
2021-02-10 13:09:02 -05:00
- [Issue tracker ](issues/index.md ): Discuss implementations with your team.
- [Issue Boards ](issue_board.md ): Organize and prioritize your workflow.
- [Multiple Issue Boards ](issue_board.md#multiple-issue-boards ): Create team-specific workflows (Issue Boards) for a project.
- [Merge Requests ](merge_requests/index.md ): Apply a branching
strategy and get reviewed by your team.
2019-05-31 07:08:09 -04:00
- [Merge Request Approvals ](merge_requests/merge_request_approvals.md ): Ask for approval before
2021-02-10 13:09:02 -05:00
implementing a change.
- [Fix merge conflicts from the UI ](merge_requests/resolve_conflicts.md ): View Git diffs from the GitLab UI.
- [Review Apps ](../../ci/review_apps/index.md ): By branch, preview the results
of the changes proposed in a merge request.
- [Labels ](labels.md ): Organize issues and merge requests by labels.
- [Time Tracking ](time_tracking.md ): Track time estimated and
spent on issues and merge requests.
- [Milestones ](milestones/index.md ): Work toward a target date.
2017-07-31 05:44:07 -04:00
- [Description templates ](description_templates.md ): Define context-specific
2021-02-10 13:09:02 -05:00
templates for issue and merge request description fields.
- [Slash commands (quick actions) ](quick_actions.md ): Create text shortcuts for
common actions.
2019-07-17 01:33:52 -04:00
- [Autocomplete characters ](autocomplete_characters.md ): Autocomplete
references to users, groups, issues, merge requests, and other GitLab
elements.
2018-04-16 11:38:03 -04:00
- [Web IDE ](web_ide/index.md )
2017-07-31 05:44:07 -04:00
**GitLab CI/CD:**
2021-02-10 13:09:02 -05:00
- [GitLab CI/CD ](../../ci/README.md ): Use the built-in [Continuous Integration, Delivery, and Deployment ](https://about.gitlab.com/blog/2016/08/05/continuous-integration-delivery-and-deployment-with-gitlab/ ) tool.
2019-09-17 08:06:48 -04:00
- [Container Registry ](../packages/container_registry/index.md ): Build and push Docker
2021-02-10 13:09:02 -05:00
images.
2020-04-06 20:09:33 -04:00
- [Auto Deploy ](../../topics/autodevops/stages.md#auto-deploy ): Configure GitLab CI/CD
2021-02-10 13:09:02 -05:00
to automatically set up your app's deployment.
2020-03-26 23:07:56 -04:00
- [Enable and disable GitLab CI/CD ](../../ci/enable_or_disable_ci.md )
2020-03-13 11:09:21 -04:00
- [Pipelines ](../../ci/pipelines/index.md ): Configure and visualize
2021-02-10 13:09:02 -05:00
your GitLab CI/CD pipelines from the UI.
2020-03-13 11:09:21 -04:00
- [Scheduled Pipelines ](../../ci/pipelines/schedules.md ): Schedule a pipeline
2021-02-10 13:09:02 -05:00
to start at a chosen time.
2020-04-10 02:09:41 -04:00
- [Pipeline Graphs ](../../ci/pipelines/index.md#visualize-pipelines ): View your
2021-02-10 13:09:02 -05:00
pipeline from the UI.
2020-03-13 11:09:21 -04:00
- [Job artifacts ](../../ci/pipelines/job_artifacts.md ): Define,
2021-02-10 13:09:02 -05:00
browse, and download job artifacts.
- [Pipeline settings ](../../ci/pipelines/settings.md ): Set up Git strategy (how jobs fetch your repository),
timeout (the maximum amount of time a job can run), custom path for `.gitlab-ci.yml` , test coverage parsing, pipeline visibility, and more.
- [Kubernetes cluster integration ](clusters/index.md ): Connect your GitLab project
with a Kubernetes cluster.
- [Feature Flags ](../../operations/feature_flags.md ): Ship different features
by dynamically toggling functionality. ** (PREMIUM)**
2017-07-31 05:44:07 -04:00
- [GitLab Pages ](pages/index.md ): Build, test, and deploy your static
2021-02-10 13:09:02 -05:00
website.
2017-07-31 05:44:07 -04:00
**Other features:**
2021-02-10 13:09:02 -05:00
- [Wiki ](wiki/index.md ): Document your GitLab project in an integrated Wiki.
- [Snippets ](../snippets.md ): Store, share and collaborate on code snippets.
- [Value Stream Analytics ](../analytics/value_stream_analytics.md ): Review your development lifecycle.
- [Insights ](insights/index.md ): Configure the insights that matter for your projects. ** (ULTIMATE)**
- [Security Dashboard ](../application_security/security_dashboard/index.md ) ** (ULTIMATE)**
- [Syntax highlighting ](highlighting.md ): Customize
your code blocks, overriding the default language choice.
- [Badges ](badges.md ): Add an image to the project overview.
- [Releases ](releases/index.md ): Take a snapshot of
the source, build output, metadata, and artifacts
2019-02-22 08:17:10 -05:00
associated with a released version of your code.
2021-02-10 13:09:02 -05:00
- [Package Registry ](../packages/package_registry/index.md ): Publish and install packages.
- [Code owners ](code_owners.md ): Specify code owners for specific files.
- [License Compliance ](../compliance/license_compliance/index.md ): Approve and deny licenses for projects. ** (ULTIMATE)**
- [Dependency List ](../application_security/dependency_list/index.md ): View project dependencies. ** (ULTIMATE)**
- [Requirements ](requirements/index.md ): Create criteria to check your products against. ** (ULTIMATE)**
- [Static Site Editor ](static_site_editor/index.md ): Edit content on static websites without prior knowledge of the codebase or Git commands.
- [Code Intelligence ](code_intelligence.md ): Navigate code.
2017-07-31 05:44:07 -04:00
2021-02-09 04:09:19 -05:00
## Project integrations
2017-07-31 05:44:07 -04:00
[Integrate your project ](integrations/index.md ) with Jira, Mattermost,
Kubernetes, Slack, and a lot more.
## Import or export a project
2017-08-16 07:05:13 -04:00
- [Import a project ](import/index.md ) from:
- [GitHub to GitLab ](import/github.md )
2019-09-25 05:06:04 -04:00
- [Bitbucket to GitLab ](import/bitbucket.md )
2017-08-16 07:05:13 -04:00
- [Gitea to GitLab ](import/gitea.md )
- [FogBugz to GitLab ](import/fogbugz.md )
2017-07-31 05:44:07 -04:00
- [Export a project from GitLab ](settings/import_export.md#exporting-a-project-and-its-data )
- [Importing and exporting projects between GitLab instances ](settings/import_export.md )
2020-11-13 13:09:11 -05:00
## GitLab Workflow - VS Code extension
To avoid switching from the GitLab UI and VS Code while working in GitLab repositories, you can integrate
the [VS Code ](https://code.visualstudio.com/ ) editor with GitLab through the
[GitLab Workflow extension ](https://marketplace.visualstudio.com/items?itemName=GitLab.gitlab-workflow ).
To review or contribute to the extension's code, visit [its codebase in GitLab ](https://gitlab.com/gitlab-org/gitlab-vscode-extension/ ).
2018-12-13 14:26:56 -05:00
## Project APIs
There are numerous [APIs ](../../api/README.md ) to use with your projects:
- [Badges ](../../api/project_badges.md )
- [Clusters ](../../api/project_clusters.md )
2019-07-15 02:10:32 -04:00
- [Threads ](../../api/discussions.md )
2018-12-13 14:26:56 -05:00
- [General ](../../api/projects.md )
- [Import/export ](../../api/project_import_export.md )
- [Issue Board ](../../api/boards.md )
- [Labels ](../../api/labels.md )
- [Markdown ](../../api/markdown.md )
- [Merge Requests ](../../api/merge_requests.md )
- [Milestones ](../../api/milestones.md )
- [Services ](../../api/services.md )
- [Snippets ](../../api/project_snippets.md )
- [Templates ](../../api/project_templates.md )
- [Traffic ](../../api/project_statistics.md )
- [Variables ](../../api/project_level_variables.md )
2019-06-14 00:04:36 -04:00
- [Aliases ](../../api/project_aliases.md )
2021-02-16 13:09:24 -05:00
- [DORA4 Analytics ](../../api/dora4_project_analytics.md )
2021-02-09 04:09:19 -05:00
2021-03-09 13:09:41 -05:00
## DORA4 analytics overview
2021-02-09 04:09:19 -05:00
Project details include the following analytics:
- Deployment Frequency
2021-02-16 13:09:24 -05:00
For more information, see [DORA4 Project Analytics API ](../../api/dora4_project_analytics.md ).