> ## Documentation Index
> Fetch the complete documentation index at: https://support.cim.build/llms.txt
> Use this file to discover all available pages before exploring further.

# Projects: organising your construction work

> A project in CIM Build is the top-level container for all drawings, documents, and analysis belonging to a single construction job.

A project in CIM Build is the top-level container for everything related to a single construction job — your uploaded drawings, specification documents, analysis results, revision history, and settings all live within it. When you open CIM Build, the **Projects** page is your starting point. Each card on that page represents one project, showing the project name, client, address, and any active risk counts at a glance. You can create as many projects as you need, one per construction job, and switch between them freely from the dashboard.

## What a project contains

Every project holds its own isolated set of data. Nothing is shared between projects unless you explicitly configure integrations such as Procore or Google Drive at the organisation level.

<CardGroup cols={2}>
  <Card title="Document sets" icon="folder-open">
    All uploaded files — tender drawings, addenda, contract sets, and revisions — organised into named sets within the project.
  </Card>

  <Card title="Analysis results" icon="shield-alert">
    Risk register items, clash detections, change register entries, and audit checklist results are all scoped to the project.
  </Card>

  <Card title="Settings" icon="settings">
    Project-level configuration including disciplines, members, labels, severity thresholds, and precedence rules.
  </Card>

  <Card title="Sub-projects" icon="layers">
    Named sub-divisions of a large project, such as "Tower A" or "Podium", used to organise files by zone or area.
  </Card>
</CardGroup>

<Note>
  All of CIM Build's analysis tools — clash analysis, change register, risk register, and audit checklists — operate within a project context. You must be inside a project to run or view any analysis.
</Note>

## Creating a project

<Steps>
  <Step title="Open the Projects page">
    From the dashboard, the **Projects** page loads by default. Click **New project** in the top-right corner to open the create project modal.
  </Step>

  <Step title="Enter project details">
    Give the project a name. Optionally add a project ID, client name, address, region, and projected start and end dates. These details appear on the project card and help you find the right project when your list grows.
  </Step>

  <Step title="Open the project">
    Click **Create** to save the project and go straight to its home page. From there you can begin uploading documents.
  </Step>
</Steps>

## Editing project details

You can update a project's name, client, address, region, dates, and external project ID at any time. Navigate to **Project Settings → General** inside the project. Each field has an inline **Edit** button — click it, make your change, and click **Save**.

## Sub-projects

For large construction jobs that span multiple zones, buildings, or packages, you can create sub-projects to keep files organised. Sub-projects are named divisions within a project — for example "Tower A", "Podium", or "Basement". You can assign one or more types to each sub-project.

To manage sub-projects, go to **Project Settings → Sub-projects**. You can create, rename, and delete sub-projects from that screen.

<Warning>
  Deleting a sub-project removes the sub-project reference from any files assigned to it, but does not delete those files.
</Warning>

## Project settings overview

The **Project Settings** sidebar gives you access to all project-level configuration:

| Section      | What you can configure                                     |
| ------------ | ---------------------------------------------------------- |
| General      | Project name, ID, client, address, region, and dates       |
| Members      | Invite team members and manage their access                |
| Disciplines  | Define and manage disciplines used for file categorisation |
| Labels       | Create custom labels for tagging analysis items            |
| Severity     | Configure severity thresholds for risk classification      |
| Precedence   | Set document precedence rules used during analysis         |
| Sub-projects | Create and manage sub-project divisions                    |
| Delete       | Permanently delete the project and all its data            |