Skip to main content
The Create project wizard opens as a slide-over panel on the right side of the screen, with a step progress bar across the top. Depending on your organization’s setup and where you launched it from, some steps are skipped automatically — the sections below note when that happens.
1

How do you want to start?

Choose between two cards: Connect a repository or Start without a repository. Connecting a repository lets Chainloop prefill the project details and run managed workflows against it; starting without one creates a bare project that you can instrument with the Chainloop CLI and link to a repository later.
Create Project wizard setup type step with Connect a repository and Start without a repository cards
This step, and the following Connect a repository step, only appear when a source-control integration is connected. If none is connected yet, the wizard opens directly on the Details step.
2

Pick a repository

Search for a repository using the search box, or scroll the list pulled live from your connected source-control provider. Each row shows the provider icon, the repository name and description, and a “Linked to <project>” badge if it’s already linked to another project.
Create Project wizard repository picker step with search box and repository list
Click Load more to page through additional repositories, or Connect new repository to add another provider connection. If the repository you’re looking for isn’t listed, use Manage access to grant Chainloop access to it — see Connect GitHub & GitLab.
3

Name your project

Enter a project Name (required). If you picked a repository in the previous step, the name is prefilled from the repository name — you can still edit it. An optional Description field accepts markdown.
Create Project wizard details step with Name and Description fields
4

Associate a product

Optionally attach the project to an existing product, create a new product for it, or click Skip this step to leave it unattached.
Create Project wizard associate product step
This step is skipped automatically when you launch the wizard from within a product.
5

Set up workflows

Choose how each workflow template runs in the project. Every card has an On/Off toggle and, when it’s on, checkboxes for the run modes the template supports: Run periodically, Run in PRs, or both. Some templates run periodically only. Each card also has an inline Configure panel for the template’s options.
Create Project wizard set up workflows step with per-template run mode controls and Configure panels
See Built-in & managed workflows for what each run mode does and which templates support which.

​
Finish

Click Create to provision the project — and the new product, if you created one — link the repository, and create the workflows you selected. A success toast confirms once everything is set up.