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

# Create New Project

> Organize your data sources and teams around projects

Stash follows a project‑based architecture designed to keep your data organized and scoped. You can create multiple projects under your company’s account, with each project linking to its own set of data sources - repositories, issue trackers, and wikis.

This structure makes it easy to keep information relevant and focused, as well as manage access: team members can be granted project‑specific permissions so they only see the data that matters to their work.

Projects bring together all your technical data sources in a single place, making everything easier to access, understand, and use effectively.

## How to create a new project?

<Steps>
  <Step title="Start New Project">
    From the Stash home screen, click **Create new project** in the **Quick Actions** panel. This will launch the **Project Creation Wizard**, which will guide you through the setup step by step.

    <img src="https://mintcdn.com/stash/9o_KO0Lz9dj79wjO/images/Home-NewProject.png?fit=max&auto=format&n=9o_KO0Lz9dj79wjO&q=85&s=54e43ba1b8b629a42888644e7a271d87" alt="Home New Project" width="6750" height="3375" data-path="images/Home-NewProject.png" />
  </Step>

  <Step title="Fill in project details">
    Enter the **name**, **description**, and **primary language** of the project.

    <img src="https://mintcdn.com/stash/9o_KO0Lz9dj79wjO/images/NewProject-Details.png?fit=max&auto=format&n=9o_KO0Lz9dj79wjO&q=85&s=01b9fba8d74c48197d3e824334f74047" alt="New Project Details" width="6750" height="3375" data-path="images/NewProject-Details.png" />
  </Step>

  <Step title=" Connect repositories">
    Add the repositories you want to link to this project. Enter the repository details and click **Validate**. Once validated, select the branch you want Stash to analyze.

    <img src="https://mintcdn.com/stash/9o_KO0Lz9dj79wjO/images/NewProject-Repos.png?fit=max&auto=format&n=9o_KO0Lz9dj79wjO&q=85&s=527cdd915985af4727b28cae5c8fcc62" alt="New Project Repos" width="6750" height="3375" data-path="images/NewProject-Repos.png" />
  </Step>

  <Step title="Connect issue trackers">
    Next, add any issue trackers you want linked to this project, such as Jira, GitHub Issues, or GitLab Issues. Select the tracker type, enter the required details, and click **Validate**.

    <img src="https://mintcdn.com/stash/9o_KO0Lz9dj79wjO/images/NewProject-Issues.png?fit=max&auto=format&n=9o_KO0Lz9dj79wjO&q=85&s=b8c72ccc283c724330415405a84ef681" alt="New Project Issues" width="6750" height="3375" data-path="images/NewProject-Issues.png" />
  </Step>

  <Step title="Connect wikis">
    If your project uses a wiki or documentation space, such as Confluence, you can connect it at this step. Enter the required details, click **Validate**.

    <img src="https://mintcdn.com/stash/9o_KO0Lz9dj79wjO/images/NewProject-Wikis.png?fit=max&auto=format&n=9o_KO0Lz9dj79wjO&q=85&s=2a32881defc030eb372369a654c1028b" alt="New Project Wikis" width="6750" height="3375" data-path="images/NewProject-Wikis.png" />
  </Step>

  <Step title="Configure project settings">
    If your issue trackers already work with Stash’s default settings, you can skip this step. Otherwise, use the configuration options to adjust how issues and labels are handled.

    <img src="https://mintcdn.com/stash/9o_KO0Lz9dj79wjO/images/NewProject-Configurations.png?fit=max&auto=format&n=9o_KO0Lz9dj79wjO&q=85&s=54612796d738f20bf4357de7f03c535d" alt="New Project Configurations" width="6750" height="3375" data-path="images/NewProject-Configurations.png" />
  </Step>

  <Step title="Review and finish">
    The summary screen shows all the repositories, issue trackers, and wikis you’ve connected. Review the information and click the confirmation button to create the project.

    <img src="https://mintcdn.com/stash/9o_KO0Lz9dj79wjO/images/NewProject-Summary.png?fit=max&auto=format&n=9o_KO0Lz9dj79wjO&q=85&s=bf22a1d3373d51e0a4c01bdbe438fed7" alt="New Project Summary" width="6750" height="4681" data-path="images/NewProject-Summary.png" />
  </Step>

  <Step title="You’re ready to go">
    <Note>
      After you finish creating a project, Stash will begin analyzing your connected data sources. Depending on the size of your project, this process may take up to **24 hours** to complete.
    </Note>

    <Warning>
      Please wait until the analysis is finished before using Stash, as results will not be accurate until the process is done.
    </Warning>

    <img src="https://mintcdn.com/stash/9o_KO0Lz9dj79wjO/images/Analysisready.png?fit=max&auto=format&n=9o_KO0Lz9dj79wjO&q=85&s=29696fae5178c2d7ec84b36ec2305ea9" alt="Analysisready Pn" width="6750" height="3375" data-path="images/Analysisready.png" />
  </Step>
</Steps>
