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

# Pipelines

> Create and manage sales pipelines, set stage permissions, and use smart tags to organize opportunities in the HoopAI Platform.

Pipelines are the backbone of the Opportunities section. Each pipeline represents a sales process with a defined set of stages that opportunities move through from open to close.

<Frame caption="The pipeline view showing stages from left to right with opportunity cards">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/enUsYkU3SAhvBk3P/images/opportunities-pipelines1.png?fit=max&auto=format&n=enUsYkU3SAhvBk3P&q=85&s=3ca2e93ff84778429cdca12e2bde5f12" alt="Pipeline board with stages and opportunity cards" width="1602" height="543" data-path="images/opportunities-pipelines1.png" />
</Frame>

## Creating a pipeline

To create a new pipeline, navigate to **Opportunities** and open **Pipeline Settings** (or **Opportunity Settings**). Click **"+ Add Pipeline"** and configure:

* **Pipeline name** — a clear name describing the sales process
* **Stages** — the steps an opportunity moves through (e.g., Lead, Qualified, Proposal, Closed Won, Closed Lost)
* **Stage colors** — optional color coding for visual clarity on the board

<Frame caption="The pipeline settings page where you create and manage pipelines">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/enUsYkU3SAhvBk3P/images/opportunities-pipelines2.png?fit=max&auto=format&n=enUsYkU3SAhvBk3P&q=85&s=c46cca1d9ea45e66eb1dfce8a49b3394" alt="Pipeline settings configuration page" width="1598" height="453" data-path="images/opportunities-pipelines2.png" />
</Frame>

<Frame caption="Add and configure pipeline stages with names and colors">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/enUsYkU3SAhvBk3P/images/opportunities-pipelines3.png?fit=max&auto=format&n=enUsYkU3SAhvBk3P&q=85&s=6fee024b2f153dd8f4c24b75c16c5c0b" alt="Pipeline stage configuration" width="1598" height="453" data-path="images/opportunities-pipelines3.png" />
</Frame>

***

## Pipeline permissions

Pipeline permissions control which team members can view, create, edit, or delete opportunities within a pipeline.

<Frame caption="Pipeline permissions settings showing role-based access controls">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/enUsYkU3SAhvBk3P/images/opportunities-pipeline-permissions1.png?fit=max&auto=format&n=enUsYkU3SAhvBk3P&q=85&s=0986dd7f303f1021704a2253aab46d54" alt="Pipeline permissions settings" width="1593" height="608" data-path="images/opportunities-pipeline-permissions1.png" />
</Frame>

<Steps>
  <Step title="Open pipeline settings">
    Navigate to **Opportunities > Opportunity Settings** and select the pipeline you want to configure.
  </Step>

  <Step title="Set permissions">
    Assign permission levels to roles or individual users:

    * **Full access** — can view, create, edit, and delete opportunities
    * **Edit** — can edit existing opportunities but cannot delete them
    * **View only** — read-only access to opportunities in this pipeline
    * **No access** — pipeline is hidden from this user or role

    <Frame caption="Configure which users have access to view and edit pipeline opportunities">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/enUsYkU3SAhvBk3P/images/opportunities-pipeline-permissions2.png?fit=max&auto=format&n=enUsYkU3SAhvBk3P&q=85&s=cb428fef04e2c8932136a9e05084507b" alt="Permission level settings for pipeline access" width="674" height="842" data-path="images/opportunities-pipeline-permissions2.png" />
    </Frame>
  </Step>

  <Step title="Save">
    Click **Save** to apply the permission changes.
  </Step>
</Steps>

***

## Smart tags in pipelines

Smart tags are automatically applied to opportunities based on conditions you define. They appear as labels on opportunity cards and help your team quickly identify deal characteristics at a glance.

<Frame caption="Opportunity cards with smart tags displayed as colored labels">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/enUsYkU3SAhvBk3P/images/opportunities-pipelines4.png?fit=max&auto=format&n=enUsYkU3SAhvBk3P&q=85&s=abc68ac6a10d0bdbd787f3b528cafad9" alt="Smart tags visible on opportunity cards" width="1598" height="453" data-path="images/opportunities-pipelines4.png" />
</Frame>

### Setting up smart tags

<Steps>
  <Step title="Open pipeline settings">
    Go to **Opportunities > Opportunity Settings** and select your pipeline.

    <Frame caption="Navigate to Opportunity Settings and select your pipeline">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/enUsYkU3SAhvBk3P/images/opportunities-pipelines5.png?fit=max&auto=format&n=enUsYkU3SAhvBk3P&q=85&s=20384d0f488c991f0400ec954dbc7505" alt="Opportunity Settings pipeline selection" width="1598" height="453" data-path="images/opportunities-pipelines5.png" />
    </Frame>
  </Step>

  <Step title="Navigate to Smart Tags">
    Click the **Smart Tags** tab.
  </Step>

  <Step title="Create a smart tag">
    Click **"+ Add Smart Tag"**. Define:

    * **Tag name** — what the tag is called
    * **Color** — visual indicator
    * **Conditions** — the criteria an opportunity must meet for the tag to be applied automatically

    <Frame caption="Configure smart tag conditions that automatically apply the tag to matching opportunities">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/enUsYkU3SAhvBk3P/images/opportunities-pipelines6.png?fit=max&auto=format&n=enUsYkU3SAhvBk3P&q=85&s=2dce87915b7fcf89b5e99dd06f0ffc05" alt="Smart tag configuration with conditions" width="847" height="755" data-path="images/opportunities-pipelines6.png" />
    </Frame>
  </Step>

  <Step title="Save">
    Click **Save**. The tag will now appear automatically on matching opportunities.
  </Step>
</Steps>

***

## Managing pipelines

From the **Opportunity Settings** screen you can:

<Frame caption="The Opportunity Settings screen showing all pipelines with management options">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/enUsYkU3SAhvBk3P/images/opportunities-pipelines7.png?fit=max&auto=format&n=enUsYkU3SAhvBk3P&q=85&s=2938b2d9a4f59cbe1e777d2afe2d92f3" alt="Opportunity Settings with pipeline management options" width="847" height="755" data-path="images/opportunities-pipelines7.png" />
</Frame>

* **Reorder pipelines** — drag and drop to change the order they appear in the pipeline dropdown
* **Rename a pipeline** — click the pipeline name to edit it
* **Archive a pipeline** — hide a pipeline without deleting historical data
* **Delete a pipeline** — permanently remove a pipeline (use with caution; this affects historical reporting)

<Frame caption="The pipeline management options including reorder, rename, archive, and delete">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/enUsYkU3SAhvBk3P/images/opportunities-pipelines8.png?fit=max&auto=format&n=enUsYkU3SAhvBk3P&q=85&s=7947e4b33ff529532100c2051cd6eceb" alt="Pipeline management action options" width="847" height="755" data-path="images/opportunities-pipelines8.png" />
</Frame>

<Warning>
  Deleting a pipeline removes all associated opportunity records. Archive instead of delete when you want to preserve historical data.
</Warning>

***

## Opportunity settings

The **Opportunity Settings** page (accessed via **Opportunities > Opportunity Settings**) controls global behaviour for the Opportunities section, including:

* **Separate contact and opportunity ownership** — enable this to allow contacts and opportunities to have different assigned owners. When off, the same user is the owner of both. Changes apply only to new records created after the setting is enabled.
* **Lost reasons** — manage the list of reasons available when marking a deal as lost
* **Deleted opportunities** — view and restore recently deleted opportunity records

<Note>
  If you enable separate ownership, review any automations that update ownership to ensure they address both contact and opportunity owners independently.
</Note>

***

## FAQs

<AccordionGroup>
  <Accordion title="How many pipelines can I create?">
    There is no hard limit on the number of pipelines. Create as many as your sales processes require — for example, separate pipelines for different product lines, regions, or deal types.
  </Accordion>

  <Accordion title="Can I change the order of stages within a pipeline?">
    Yes. In Pipeline Settings, drag and drop stages to reorder them. Cards on the board rearrange to reflect the new order.
  </Accordion>

  <Accordion title="What happens to opportunities if I delete a stage?">
    You will be prompted to move any existing opportunities in that stage to another stage before deletion can proceed.
  </Accordion>

  <Accordion title="Can I revert to shared ownership after enabling separate ownership?">
    Yes. Toggle the setting off in Opportunity Settings. New opportunities and contacts created after disabling will revert to shared ownership. Existing records are not affected.
  </Accordion>

  <Accordion title="Will enabling separate ownership change existing records?">
    No. The separate ownership setting only applies to opportunities and contacts created after the setting is enabled. Existing records retain their current ownership.
  </Accordion>

  <Accordion title="What permission levels are available for pipelines?">
    Four levels are available: **Full access** (view, create, edit, delete), **Edit** (edit existing but cannot delete), **View only** (read-only), and **No access** (pipeline hidden from this user or role).
  </Accordion>
</AccordionGroup>
