# Add a Project

A project is the workspace item that contains one garment model, its imported source data, the calculated sizes, pieces, sections, report image or DXF geometry, and the generated PDF report.

In Pesipiuma v3, creating a project only creates the project container. Source data is imported immediately after creation from the editor.

{% hint style="info" %}
The **New Project** action is available only to users with write access.
{% endhint %}

## Create a new project

1. Open the Dashboard.
2. Click **New Project**.
3. Enter the **Project name**.
4. Optionally enter a **Description**. This can be used for brand, line, season, or other report header information.
5. Optionally assign one or more **Tags**.
6. Click **Add Project**.

After the project is created, Pesipiuma opens the editor.

## Add source data

In the editor, choose how to start the project:

* **Import DXF**: upload a DXF file and, if available, the optional RUL grading file.
* **Import Excel**: upload Excel files generated by a supported CAD importer.

The import method becomes part of the project after the first successful import. A DXF project cannot later be switched to Excel import, and an Excel project cannot later be switched to DXF import.

{% hint style="warning" %}
Create a separate project if you need to test a different import method for the same garment model.
{% endhint %}

## Project fields

The **New Project** dialog includes:

* **Project name**: required. This is the name shown on the dashboard, in the editor, and in reports.
* **Description**: optional. Use it for brand, line, season, customer, or other report header context.
* **Tags**: optional. Tags organize and filter projects inside the workspace.

Project creation does not include:

* File upload.
* Size creation.
* Piece creation.
* Report generation.

Those operations happen later in the editor through the selected import workflow.

{% hint style="info" %}
If you already filtered the dashboard by tags, use the same tags in the **New Project** dialog to keep the new project organized with the current selection.
{% endhint %}

{% content-ref url="/pages/DPSu8K9UviQX2COv18FZ" %}
[Using the Importers](/en/using-pesipiuma/using-the-importers.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.pesipiuma.app/en/workspace-management/model-operations/add-a-model.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.