Skip to main content
This guide takes you from an empty instance to a project that a team can use on day one: its own fields, work item types, workflows and views, packed into a template. Follow the phases in order; each one builds on the previous one.

At a glance

Overview

Phase 1: Fields

Phase 1 of 5, about 10 minutes. Next: Work item types.
1

Create the fields

In System Settings → Content & Organization → Custom Fields, click New Field for each value the team must record, for example “Customer” as Single choice.
2

Group them

In Field Collections, click New, name the collection and add the fields. Click Edit, switch on Work Items under Applies To, and switch on Show on Create if members should fill them in right away.
The collection shows Tasks in the list and the fields under Fields. If a field is missing, see Create a field collection.
Next: Phase 2: Work item types

Phase 2: Work item types

Phase 2 of 5, about 5 minutes. Previous: Fields. Next: Workflows.
1

Create the types

In Work Item Types, click New Work Item Type for each kind of work, for example “Bug” and “Feature”. Mark the most common one with Set as default.
2

Link type-specific fields (optional)

If a collection belongs to one type only, link that type to it under Work Item Types in the collection.
The Work Item Types list shows your types with their Collections. Details: Work item types.
Next: Phase 3: Workflows

Phase 3: Workflows

Phase 3 of 5, about 15 minutes. Previous: Work item types. Next: Template.
1

Create the workflow

In Workflows, click New Workflow, name it and click Open Editor.
2

Add statuses

Click Add Status for each status, starting with the one new work items should start in. Set the Category of each.
3

Draw transitions

Connect the statuses and name each transition. Add validators or transition fields where the process needs them.
The workflow card shows your statuses. If you plan a separate flow for one type, for example bugs, create that workflow too. Details: Design workflows.
Next: Phase 4: Template

Phase 4: Template

Phase 4 of 5, about 10 minutes. Previous: Workflows. Next: Project.
1

Create the template

In Project Templates, click New Template. Choose the views and features, add the workflows, map types to workflows, and select the work item types and field collections.
2

Publish it

Switch on Published and click Create Template.
The card under Your templates shows Offered. Details: Project templates.
Next: Phase 5: Project

Phase 5: Project

Phase 5 of 5, about 5 minutes. Previous: Template.
1

Create the project

In a Space, click New Project, choose your template under Custom Templates and click Continue with the template name.
2

Name it

Enter the Project Name. Collabase fills in the Project key, the prefix of work item numbers, from the name as you type, for example WR for Website Relaunch. Change the key if you want another one; once you have edited it, it stays as you set it. Click Create Project.
3

Check the settings

Collabase opens the project’s Settings tab. General shows Synced with template. Under Fields, check that your collections are listed as assigned.
Create a work item of each type. The fields of your collections appear, and the status buttons follow your workflow. If fields are missing, see Troubleshooting.

Keep it running

Troubleshooting

Configuration model

How instance, Space and project settings relate.

Project settings

What a project can change for itself.
Last modified on October 23, 2026