---
title: "Create a project"
description: "Set an identifier, choose initial properties, and start a project plan."
canonical_url: "https://initera.app/projects/creating-projects"
---

> Index of every page on this site: [llms.txt](https://initera.app/llms.txt)

Create a project when several issues contribute to one outcome. A project has its own summary, description, milestones, resources, updates, and issue list.

![New project dialog with name, summary, properties, description, and milestones](https://initera.app/images/app/create-project.png)

## Open the project composer

Select the plus button beside **Projects** in the sidebar, or open **Workspace → Projects** and select **New project**. Press **N** then **P** while focus is outside a text field if you prefer the keyboard.

The composer shows the current workspace at the top. Check it before you save. Projects belong to one workspace.

## Enter the project details

1. Enter a name that describes the outcome, such as “Desktop release.” The name appears in the sidebar and project index.
2. Add a short summary. It gives the project list and overview a one-line explanation.
3. Set an identifier of two to eight letters. New issues assigned to the project use it as their prefix. Choose an abbreviation you can recognize in issue links.
4. Select the icon above the name to choose a symbol and color. The icon appears beside the project in the sidebar and index.
5. Choose the starting status, priority, and dates if you know them. You can edit them from the overview later.
6. Write a longer brief in the description when the goal or constraints need context.
7. Add the first milestone if there is a known stage or target. Otherwise, add it after the project exists.
8. Select **Create project**.

The identifier identifies issues rather than the project name. Keep it stable once people start citing issue IDs outside the app.

## After creation

Open the project from the sidebar or project index. Select values in the right-side Properties panel to change status, priority, dates, lead, or labels. Select the name or summary to edit its text. Add resources when the project depends on a specification or external link.

Assign an existing issue by opening it and choosing the new project in its **Project** property. Review the identifier prompt if its prefix will change. The project issue count and progress update from its assigned issues.

Read [Projects](https://initera.app/projects/projects) for the overview and lifecycle, [Project structure](https://initera.app/projects/project-structure) for modules and features, and [Issue properties](https://initera.app/issues/issue-properties) for moving issues.

## FAQ

### Do I need to create issues first?

No. Create the project, then add or move issues into it when the work is clear.

### Can I change the icon later?

Yes. Select the icon on the project overview to choose another symbol or color.

### What if the project has no milestone yet?

Leave Milestones empty. Add a milestone from the overview when you know the first stage. Issues can belong to the project without a milestone.

### Can I put the same project in two workspaces?

No. A project belongs to one workspace. Switch to the intended workspace before you create it.

## Sitemap

See the full [sitemap](https://initera.app/sitemap.md) for all pages.
