# Pipelines: board, table, and statuses

> Create a pipeline from scratch or a template, move opportunities through its statuses, and manage statuses, archiving, and deletion in pipeline settings.

## Before you start

- A pipeline is an ordered set of statuses (the board's columns) that
  opportunities move through. The UI mostly says "opportunity"; pipeline cards
  and dialogs also say "project" for the same thing, and some screens call a
  status a "stage" (the **Stage** field in **New opportunity**, for example).
- The **Pipelines** page lists every pipeline your account has created. Once at
  least one is archived, a **Show archived (N)** switch appears at the top; turn
  it on to include archived ones, each with an **Archived** badge under its name.
  Before you've made any, the page reads "No pipelines yet" and "Create your
  first pipeline from scratch or start from a template."
- Everyone on your account, admins and members alike, can create pipelines, edit
  statuses, and move opportunities between them.

## Steps

### Create a pipeline

1. On the **Pipelines** page, click **New pipeline**.

2. In the **New pipeline** dialog, choose **Start from scratch** or **Use a
   template**. Either choice opens a short second step in the same dialog; click
   **Back** to return to the choice.

   - **Start from scratch** asks for a **Name** and an optional **Description**. It
     starts with a single "New" status you build on from there.
   - **Use a template** lists ready-made templates (currently the **Standard
     Project Pipeline**: New, In Progress, On Hold, Won, Lost) and lets you
     give the new pipeline its own **Name** (optional; leave it empty to use the
     template's name).

   _Screenshot: The New pipeline dialog with Blank and From template tabs, the Standard Project Pipeline template selected showing its five statuses._

3. Click **Create pipeline** (from scratch) or **Use template** (template).
   You're taken straight to the new pipeline's board.

A pipeline started from scratch needs a name ("Name is required"); a template
pipeline needs a template picked ("Pick a template"). A template is copied once, at creation: the new
pipeline's statuses are yours to rename, recolour, reorder, or delete, and later
changes to the template never reach pipelines already created from it. Templates
themselves can't be edited or added to from the portal.

### Manage a pipeline from its card

Each card on the **Pipelines** page has a **⋮** menu with three items:

- **Edit** opens the **Edit pipeline** side panel to change the **Name** and
  **Description**, then **Save changes**.
- **Archive**, or **Restore** on a card that's already archived.
- **Delete** asks "Delete pipeline?" and reminds you that a pipeline can only be
  deleted once it has no opportunities.

_Screenshot: A pipeline card's ⋮ menu open on the Pipelines page, showing Edit, Archive, and Delete._

The card itself shows the pipeline's whole name (wrapped, never cut off), an
**Archived** badge under the name when it's archived, its description ("No
description" if it has none), and how many projects and statuses it holds. Click
anywhere else on the card to open its board.

### Work the board

Each pipeline's **Board** shows its statuses as columns, in order. A column
header shows its color, label, and opportunity count; click the label to
rename the column inline. Click the **⋮** menu on a column for **Move left**,
**Move right**, **Archive**, or **Delete**. An empty column reads "No
opportunities".

_Screenshot: The pipeline board: status columns Inquiry, Qualified, Proposal, and Negotiation, each with its count and ⋮ menu, holding opportunity cards that show the name, description, tags, and owner; Board, Table, and Settings switches and the New opportunity button sit above the columns._

Drag a card to another column to change which status it's in, or drag it up
or down within a column to reorder it there. Both save automatically as you
drop. The column a card sits in is the opportunity's **Status**: the **Status** row
on the opportunity's own page shows the same column, so moving the card here changes
it there too.

Each card shows the opportunity's name (click it to open the opportunity), its
description, tags, and owner. Hover over a card to see its **⋮** menu, which offers
**Move to another pipeline** and opens the **Move opportunity** dialog: pick a **Destination pipeline** and a **Status** in it, then
move ("Pick a destination pipeline and status" if you leave either empty). Archived
pipelines aren't offered as destinations, though you can always move an opportunity
_out_ of an archived pipeline from its **Table** view (an archived board has no card
menus).

After the move, the opportunity's **Status** is the column you picked in the
destination pipeline. See [Opportunity statuses](https://kb.incenti.co/contacts-and-pipeline/opportunity-statuses.md).

An info banner above the board reads "Projects in a Won column with recorded
incentive awards are tracked in Compliance," with a link to Compliance;
dismiss it with its close button.

Click **Add status** at the end of the columns to open the **Add status** side
panel, then give the column a **Label**, a **Category** (Active, Inactive, or
Closed), and a **Color**, and click **Add status** again to save it. A blank
**Label** is refused ("Label is required"). An archived pipeline's board has no
**Add status** button.

Click **New opportunity** in the pipeline's header (top right) to open the **New
opportunity** side panel and create an opportunity directly into a column of your
choice: pick the **Stage**, then enter a **Project Name**, **Description**, **Start
date**, **Due date**, and **Owner**, and click **Create opportunity**. **Owner** is
required ("You must provide an owner."). The **Stage** you pick is the new
opportunity's **Status**; change it later by moving the card. This panel is also the
only place a **Due date** can currently be set.

### Work the table

Switch to **Table** for a sortable list of the pipeline's opportunities instead of
columns. **Search opportunities** matches the opportunity **name only**, not the
owner, the tags, or the description, and the **All statuses** dropdown narrows the
list to one column. Click the **Name** column header to sort alphabetically. Columns
show Name, Status, Owner, Tags, and Updated. Each row's **⋮** menu offers **Move to
another pipeline**, opening the same dialog as on the board. A search or filter that
matches nothing shows "No opportunities found."

_Screenshot: The pipeline's Table view: a search box and All statuses filter above a table of opportunities with Name, Status, Owner, Tags, and Updated columns._

### Manage pipeline settings

Open **Settings** to rename or describe the pipeline, and to manage its
statuses. The page is a centered column of three cards: **Pipeline details**
(**Name**, **Description**, and **Save**), **Statuses**, and **Danger zone**.

_Screenshot: The Statuses card in pipeline settings, listing each status with its color, label, Category and Outcome dropdowns, reorder arrows, and archive/delete buttons._

For each status, you can:

- Click its color dot to change color, and edit its label directly.
- Set its category dropdown to **Active**, **Inactive**, or **Closed**.
- Set its outcome dropdown to **None**, **Won**, or **Lost**.
  Marking a status **Won** is what makes its opportunities show up in
  Compliance.
- Reorder it with the up/down arrows.
- **Archive** it (hides it from the board without deleting it; archived
  statuses stay on any opportunities that already have them, and can be
  restored from the **Archived statuses** list at the bottom of this card).
- **Delete** it. If it still has opportunities on it, you're asked to pick
  another status to move them to first; an empty status deletes immediately.

To add a column from here, type its name in **New status label** at the bottom
of the list and click **Add status**; set its category, outcome, and color in
the row that appears.

### Archive or delete a pipeline

The **Danger zone** card at the bottom of **Settings** has two actions:

- **Archive pipeline** archives it immediately, with no confirmation
  step. An archived pipeline's board becomes read-only (you'll see "This
  pipeline is archived. The board is read-only." at the top), and it no
  longer offers **New opportunity**.
- **Delete pipeline** asks you to confirm ("Delete pipeline?"). A pipeline can
  only be deleted once it has no opportunities left in it.

To restore an archived pipeline, go back to the **Pipelines** page, turn on
**Show archived**, and choose **Restore** from the pipeline card's **⋮**
menu, or click **Restore pipeline** in that pipeline's own **Settings**
Danger zone card.

## What happens next

- Dragging a card to a different column saves in the background as soon as
  you drop it; if the save fails, the card snaps back and you'll see an
  error toast.
- Marking a column's Outcome as **Won** immediately re-checks every
  opportunity already sitting in it against Compliance, so awards recorded
  on those opportunities appear there without you having to touch each one.
- Deleting a status that still has opportunities moves all of them to the
  status you picked before the delete completes.
- Moving an opportunity to another pipeline sets its **Status** to the column you
  picked and re-checks it against Compliance. Nobody is notified about the move.

## Common questions

**Q: I dragged a card to "Won". Does the opportunity's status change too?**
A: Yes. The column a card sits in is the opportunity's **Status**, so the
**Status** row on the opportunity's own page shows "Won" after the move.

**Q: I archived a pipeline by mistake. How do I get it back?**
A: Open the pipeline's **Settings** and click **Restore pipeline** in the
Danger zone, or go to **Pipelines**, turn on **Show archived**, and choose
**Restore** from the pipeline's **⋮** menu. Archiving has no confirmation
step, so nothing else needs to be undone.

**Q: Can I search the Table view by owner or tag?**
A: No. The table's search box matches the opportunity name only. Use the **All
statuses** dropdown to narrow by column, and sort by clicking a column header.

**Q: Can I edit a pipeline template, or set a default pipeline?**
A: Neither. Templates are fixed starter layouts and a new pipeline copies one at
creation. After that the pipeline is entirely yours to change, and template updates
never flow into it. There's also no "default" pipeline: an opportunity created from a
board belongs to that board's pipeline.

**Q: Why won't a status or pipeline delete?**
A: A status with opportunities on it needs a destination status chosen first;
a pipeline can't be deleted while it still has any opportunities in it.
Archiving is the alternative when you want to stop using something without
requiring it to be empty first.

## Related

- [Contacts and organizations](https://kb.incenti.co/contacts-and-pipeline/contacts-and-organizations.md)
- [Opportunities](https://kb.incenti.co/contacts-and-pipeline/opportunities.md)
- [Find an opportunity, its stage, and its economic impact](https://kb.incenti.co/contacts-and-pipeline/find-an-opportunity.md)
- [Opportunity statuses](https://kb.incenti.co/contacts-and-pipeline/opportunity-statuses.md)
- [Notes](https://kb.incenti.co/contacts-and-pipeline/notes.md)
- [Tags](https://kb.incenti.co/contacts-and-pipeline/tags.md)
- [Review a response](https://kb.incenti.co/responses/review-a-response.md)
