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

# Create a Pipeline

> Step by step to create a Pipeline in BluBash: template, deal fields, teams with access, stages with deadlines, close destination and reasons.

The **New pipeline** wizard has six steps: **Type**, **Details**, **Teams**, **Stages**, **Reasons** and **Review**. You can change every choice later, so you do not need to get everything right the first time.

<Note>
  Creating and editing Pipelines requires the **Admin** or **Manager** role. Members use their teams' Pipelines but do not see the **New pipeline** button.
</Note>

## Before you start

* Create the teams that will use the Pipeline. Pipeline access comes from the team. [Create and configure teams →](/account-settings/create-configure-teams)
* List the real stages of your process and the criterion for a deal to enter each one.
* Define won and lost reasons using the names your team already uses.

## Step by step

Go to **Pipelines** in the sidebar and click **New pipeline**.

<Frame>
  <img src="https://mintcdn.com/blubash-04458f0b/A9z6patfkk5ZkoQF/images/pipelines/novo-pipeline-botao.png?fit=max&auto=format&n=A9z6patfkk5ZkoQF&q=85&s=7e44b95aa6f9fbd4a6eafefab126c2f2" alt="New pipeline button in the top right corner of the Pipelines screen" width="2560" height="1600" data-path="images/pipelines/novo-pipeline-botao.png" />
</Frame>

<Steps>
  <Step title="Type: choose a template">
    Under **Pipeline type**, choose **Sales**, **Support**, **Onboarding**, **Collections** or **Custom**. The template sets the starting stages, fields and reasons. You adjust everything in the next steps.

    | Template | A deal represents | Starting point |
    | - | - | - |
    | **Sales** | Opportunity | Value, recurrence and a required reason when lost |
    | **Support** | Request | Priority and stage deadlines, no value |
    | **Onboarding** | Project | Due date and stage deadlines |
    | **Collections** | Invoice | Amount due and due date |
    | **Custom** | Whatever you define | Starts empty: you set the fields and stages |

    <Frame>
      <img src="https://mintcdn.com/blubash-04458f0b/A9z6patfkk5ZkoQF/images/pipelines/criar-pipeline-1-tipo.png?fit=max&auto=format&n=A9z6patfkk5ZkoQF&q=85&s=14717e93545fe353fba6c8c1eade55a5" alt="Type step of the wizard with the Sales, Support, Onboarding, Collections and Custom templates" width="2560" height="1600" data-path="images/pipelines/criar-pipeline-1-tipo.png" />
    </Frame>
  </Step>

  <Step title="Details: name, description and deal fields">
    Enter the **Pipeline name** (required) and, if you want, a **Description (optional)** that explains what the Pipeline is for and who uses it.

    Under **Fields and rules**, enable only what fits the process:

    | Option | What it does |
    | - | - |
    | **Monetary value** | Shows a single value on the deal and sums values per stage on the board |
    | **Recurring value** | Lets you record a subscription or monthly amount in addition to the one-time value |
    | **Value currency** | Appears when a value field is on: Real (BRL), US Dollar (USD) or Euro (EUR) |
    | **Priority** | Shows Low, Medium, High or Urgent on each deal |
    | **Due date** | Shows the expected completion or due date on the deal |
    | **Deal additional fields** | Chooses which workspace deal fields appear on this Pipeline's deals. Empty means none |

    If there are no deal fields yet, use **Manage deal fields** to create them.

    <Frame>
      <img src="https://mintcdn.com/blubash-04458f0b/A9z6patfkk5ZkoQF/images/pipelines/criar-pipeline-2-detalhes.png?fit=max&auto=format&n=A9z6patfkk5ZkoQF&q=85&s=20b818be1fd3a1dbd339db5d0362afd8" alt="Details step with pipeline name, description and the Monetary value, Recurring value, Priority and Due date options" width="2560" height="1600" data-path="images/pipelines/criar-pipeline-2-detalhes.png" />
    </Frame>
  </Step>

  <Step title="Teams: define who has access">
    Select the teams that will use the Pipeline. Access comes from the team, not the Pipeline: members of a linked team can see the Pipeline and its deals. At least one team is required to continue.

    <Frame>
      <img src="https://mintcdn.com/blubash-04458f0b/A9z6patfkk5ZkoQF/images/pipelines/criar-pipeline-3-equipes.png?fit=max&auto=format&n=A9z6patfkk5ZkoQF&q=85&s=340c685203e29d10ca662cbf1714b4e9" alt="Teams step with the Sales team selected" width="2560" height="1600" data-path="images/pipelines/criar-pipeline-3-equipes.png" />
    </Frame>
  </Step>

  <Step title="Stages: columns, deadlines and close destination">
    Under **Board columns**, adjust stage names, colors and order. The order of the list is the column order on the board. Drag to reorder and use **Add stage** to add new columns.

    On each open stage, click **Set a deadline on this stage** to enter a **Maximum time in this stage**, in **Days** or **Hours**. When a deal stays longer than that, its card is highlighted on the board.

    <Frame>
      <img src="https://mintcdn.com/blubash-04458f0b/A9z6patfkk5ZkoQF/images/pipelines/criar-pipeline-4-etapas.png?fit=max&auto=format&n=A9z6patfkk5ZkoQF&q=85&s=f1aba6d3dd5fec386fc7fdf7a9f739c7" alt="Stages step with the board columns and the maximum time for each stage" width="2560" height="1600" data-path="images/pipelines/criar-pipeline-4-etapas.png" />
    </Frame>

    Under **Deal end** you find the **Won** and **Lost** stages. Every Pipeline needs at least one open stage, one Won stage and one Lost stage. To change a stage's nature, use **Stage type** in the stage menu.

    Click **Set a close destination on this stage** on an end stage so that, when a deal closes there, BluBash automatically creates a deal in another Pipeline.

    <Frame>
      <img src="https://mintcdn.com/blubash-04458f0b/A9z6patfkk5ZkoQF/images/pipelines/criar-pipeline-4-destino-ao-fechar.png?fit=max&auto=format&n=A9z6patfkk5ZkoQF&q=85&s=93e03c4880086dfc540eb905e091087d" alt="Won stage set to create the deal in the Onboarding pipeline, Kickoff stage" width="2560" height="1600" data-path="images/pipelines/criar-pipeline-4-destino-ao-fechar.png" />
    </Frame>

    [Learn more about deal derivation →](/pipelines/derive-deals)
  </Step>

  <Step title="Reasons: why the deal was won or lost">
    Add **Won** and **Lost** reasons using names your team already uses every day. Turn on **Require reason on win** and **Require reason on loss** so nobody closes a deal without recording why. To require a reason, the list must have at least one reason.

    <Frame>
      <img src="https://mintcdn.com/blubash-04458f0b/A9z6patfkk5ZkoQF/images/pipelines/criar-pipeline-5-motivos-perdido.png?fit=max&auto=format&n=A9z6patfkk5ZkoQF&q=85&s=b161ae15e9f019bba6155220976d0935" alt="Reasons step with the list of Lost reasons and the require reason on loss option turned on" width="2560" height="1600" data-path="images/pipelines/criar-pipeline-5-motivos-perdido.png" />
    </Frame>

    <Tip>
      Add **Not qualified** as a lost reason. This way you do not need a discard stage, and you can measure how many leads were not a fit.
    </Tip>
  </Step>

  <Step title="Review: check and create">
    Under **Ready to create**, check **Who can access**, **Board columns**, **Deal fields** and **Close reasons**. Click **Create pipeline**. The setup applies to the board right away.

    <Frame>
      <img src="https://mintcdn.com/blubash-04458f0b/A9z6patfkk5ZkoQF/images/pipelines/criar-pipeline-6-revisao.png?fit=max&auto=format&n=A9z6patfkk5ZkoQF&q=85&s=93904afad4e864ed0d82784ed9d495fb" alt="Review step with the pipeline summary before creation" width="2560" height="1600" data-path="images/pipelines/criar-pipeline-6-revisao.png" />
    </Frame>
  </Step>
</Steps>

## Edit a Pipeline after creating it

On the board, click **Pipeline options**, next to the Pipeline selector:

| Option | What it does |
| - | - |
| **Edit pipeline** | Opens the settings with the **General**, **Teams**, **Stages**, **Reasons** and **Delete** tabs |
| **Manage stages** | Opens the stages tab directly, to rename, reorder and set deadlines and destinations |
| **Reorder pipelines** | Sets the order of Pipelines in the selector |
| **Delete pipeline** | Removes the Pipeline from the workspace |

Save with **Save changes** or, on the stages tab, with **Save stages**.

## Limitations and cautions

* **Deleting a stage with deals**: BluBash asks for an open destination stage and moves the deals before deleting (**Move and delete**). Won or Lost stages cannot receive those deals.
* **Deleting a Pipeline**: only allowed when there are no open deals. You confirm by typing the Pipeline name, and the action cannot be undone.
* **Unlinking teams**: if you are not on a linked team, only an Admin can unlink it.
* **No team, no board**: a Pipeline only appears to members of at least one linked team.

## Best practices

* Start from a template and remove what you do not use, instead of building everything from scratch.
* Set deadlines only on stages where delays are a real problem, such as **Proposal sent**.
* Review the stages after two or three weeks of use, based on where deals get stuck.

## Next steps

<CardGroup cols={2}>
  <Card title="Work with deals" icon="briefcase" href="/pipelines/deals">
    How to create, move and track deals on the board and in the conversation.
  </Card>

  <Card title="Won, Lost and reasons" icon="flag" href="/pipelines/won-lost-reasons">
    How to set up and use close reasons.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.