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

# Journey Hub

> Track and manage your government contracting opportunities through the full capture pipeline

> [!TIP]
>
> Journey Hub is your pipeline management workspace. Create journeys, move them through pipeline stages, assign tasks to your team, build a compliance matrix, and generate proposals — all in one place.

![Journey Hub Kanban board view](https://mintcdn.com/samsearch/Ndq-dGSWLS30S7mV/images/journey-hub/journey-hub-main.jpg?fit=max\&auto=format\&n=Ndq-dGSWLS30S7mV\&q=85\&s=964e8851d511bf4777eff99e33cae1c9)

## What is a Journey?

A **Journey** (also called a "pursuit") is created when you decide to actively pursue an opportunity. It tracks everything from your initial assessment through final submission — documents, tasks, notes, contacts, compliance, and the generated proposal all live in one workspace per bid.

Journey Hub is shared across your whole organization — every journey a teammate creates is visible to the rest of the org (subject to the [visibility setting](#visibility--sharing) on that specific journey). This is different from **Saved Opportunities**, which are private to each login and do not sync between teammates. If you and a colleague both use SamSearch, the fastest way to make sure you're both looking at the same pipeline is to work in Journey Hub, not each person's individual saved list.

## Creating a Journey

There are two ways to start a journey, and they are not equivalent.

### From an Opportunity (recommended)

1. Open any opportunity from Search, Leads, or Recommendations
2. Click **Start Journey**
3. A journey is created automatically with the opportunity's details pre-filled, and stays linked to that source listing

Because the journey is linked to the live opportunity, it keeps receiving **amendment and update tracking** for as long as it exists — see [Amendment Sync](#documents) below.

### From Journey Hub Directly

1. Go to **Journey Hub** under the **Management** section of the left sidebar
2. Click **+ New Journey** in the top right corner (or use the inline **+** on any column to create it directly in that stage)
3. Fill in the title, status, due date, visibility, assignees, and optional description
4. Click **Create Journey**

![New Journey creation panel with title, status, due date, visibility, and assignee fields](https://mintcdn.com/samsearch/zeNhOlOARkPzzRTv/images/journey-hub/journey-new-button.png?fit=max\&auto=format\&n=zeNhOlOARkPzzRTv\&q=85\&s=8b13ab45ff19ce59e5e14880827bf45a)

> [!WARNING]
>
> A journey created this way is **not linked to a live government listing** — it's an "Upload" type journey. That means it will **never receive amendment or solicitation-update tracking**, because there's no source opportunity to sync against. If you want ongoing amendment tracking for a real listing, always use **Start Journey** from the opportunity page itself rather than creating the journey from scratch and pasting in the details.

## Pipeline Stages

Every organization starts with five default stages, each carrying a default win probability used to weight your pipeline value:

| Stage | Default win probability | Can be deleted? | Win probability editable? |
| - | - | - | - |
| **Assessment** | 10% | No — locked | Yes |
| **In Progress** | 25% | Yes, if empty | Yes |
| **Submitted** | 50% | Yes, if empty | Yes |
| **Won** | 100% | No — locked | No — fixed |
| **Lost / No-Bid** | 0% | No — locked | No — fixed |

Two separate locks are at work here, and it's easy to mix them up:

* **Deletion lock** — Assessment, Won, and Lost/No-Bid can never be deleted, even if empty. In Progress and Submitted *can* be deleted (once empty) despite being default columns.
* **Win-probability lock** — only Won (always 100%) and Lost/No-Bid (always 0%) have a probability you cannot change. Assessment's 10% is just a normal default and can be edited like any custom column.

Deleting a column moves every journey in it to **Assessment** — journeys are never deleted or hidden when a column is removed.

> [!WARNING]
>
> Dragging a card between columns — including into **Won** or **Lost/No-Bid** — happens instantly with **no confirmation prompt**. There's no "are you sure" step before marking something Won or Lost, so a stray drag can change a journey's stage immediately. If you need a second check before closing out a bid, build that into your team's process rather than relying on the UI to ask.

### Customizing Board Columns

> [!NOTE]
>
> Only **Admins**, **Owners**, and members who've been granted the **Edit Board Columns** [permission](https://docs.samsearch.co/features/settings.md#member-permissions) can edit board columns. Everyone else sees the columns as configured by their organization. Columns are shared across every AI Profile in your org — a change here affects everyone.

Click the **Columns** button on the Board to open the column manager, where you can:

* **Add** a new column
* **Rename** any column — including Assessment, Won, and Lost/No-Bid
* **Reorder** columns by dragging them in the manager
* **Delete** a non-locked, empty column
* **Set a win probability** on any non-locked column, using the slider or preset percentages

> [!NOTE]
>
> A win probability is **optional** on a custom column. A column with none set shows `no win % set` under its name and contributes nothing to your **Weighted** pipeline figure — its journeys still count toward the raw **Pipeline** total. Set a probability on every column you want reflected in the weighted number.

![Kanban board Columns manager for adding, renaming, reordering, and deleting board columns](https://mintcdn.com/samsearch/l7UUPFoe9cnssSs2/images/journey-hub/kanban-columns-manager.png?fit=max\&auto=format\&n=l7UUPFoe9cnssSs2\&q=85\&s=8cfc48e79a7797d7c62fc761e0adc7e2)

## View Modes

Switch between four views using the controls at the top of Journey Hub:

> [card] Board
>
> The default view — journeys organized by pipeline stage. Drag and drop cards between columns to update status. Columns can be collapsed to a narrow strip to save space, and you can still drop a card into a collapsed column.

> [card] Calendar
>
> Journeys with a due date plotted on a month grid. Drag an event to a new day to reschedule it. Journeys in Lost/No-Bid show a red "Lost / No-Bid" pill instead of a due-date label.

> [card] Table
>
> A sortable, filterable grid with inline editing, bulk actions (status, assignment, delete), and keyboard navigation. An **overdue** counter and toggle let you isolate just what's late.

> [card] My Tasks
>
> Your personal task workspace — every task assigned to you across all journeys, plus your @mentions and the journeys you're involved in. See below for full details.

![Journey Hub Board view with pipeline value and weighted value shown per column](https://mintcdn.com/samsearch/q2xIowBb7pN3WT5s/images/journey-hub/journey-board.png?fit=max\&auto=format\&n=q2xIowBb7pN3WT5s\&q=85\&s=1918d471e1605196ebbc682caefae0a9)

![Table view with an overdue journeys counter and toggle](https://mintcdn.com/samsearch/zeNhOlOARkPzzRTv/images/journey-hub/journey-table-overdue.png?fit=max\&auto=format\&n=zeNhOlOARkPzzRTv\&q=85\&s=a16833212749e86406d5ed8062d0a601)

Your last-used view is remembered across sessions.

## My Tasks

> [!TIP]
>
> My Tasks is your personal workspace inside Journey Hub — a single view of every task assigned to you across all your journeys, so you never have to open each journey individually to find your work.

* Click **My Tasks** in the view switcher at the top of Journey Hub
* Or open your **Dashboard** and click the **My Tasks** card

### Tasks Tab

Shows your assigned tasks, with:

* **Quick filters** — All / Overdue / Today / This week (each with a live count)
* **Status filter** — All / To Do / In Progress / Done
* **Group by** — Due date (default: Overdue, Today, This week, Later, Completed), Journey, Status, or Priority
* **Scope toggle** — **My tasks** (assigned to you) vs. **All tasks** (every task across all your journeys, with assignee avatars shown)

Click the checkbox on any row to mark a task done instantly. Click a row to open the task detail page.

### Mentions Tab

Every @mention directed at you across every journey — who mentioned you, the message, the parent journey or task, and a timestamp. Unread mentions are highlighted; clicking one marks it read and takes you to the task (or the journey Overview if it wasn't task-specific).

### Journeys Tab

Every journey you own or are actively assigned to, with a progress bar of your own tasks within that journey (done vs. total). Click any journey card to open it.

***

## Filters

The filter bar has six chips:

| Filter | Type |
| - | - |
| **Type** | Multi-select (Federal, SLED, GSA eBuy, Grant, SBIR/STTR, Recompete, Forecast, Subcontracting, DIBBS, Canada, Upload) |
| **Due Date** | Date range |
| **Owner** | Single-select (defaults to "Me" first, then teammates) |
| **Assignee** | Multi-select |
| **Status** | Single-select over your live board columns |
| **Visibility** | Single-select (Shared / Private) |

There's also a free-text **search** box (matches title and solicitation number) and an **Export** button that downloads the currently filtered list as CSV.

> [!WARNING]
>
> **The Assignee filter is AND, not OR.** Selecting two teammates in the Assignee filter shows only journeys assigned to **both** people — not journeys assigned to either one. If you expected "show me anything assigned to Alice or Bob" and got an empty or much-shorter list than you expected, this is why.

***

## Journey Features

Each journey opens into its own workspace with several tabs.

### Overview

![Journey Overview tab showing status, due date, value, owner, assignees, description, and notes](https://mintcdn.com/samsearch/zeNhOlOARkPzzRTv/images/journey-hub/journey-overview.png?fit=max\&auto=format\&n=zeNhOlOARkPzzRTv\&q=85\&s=53f2be96ece1a004ce7bf87ea148c4ad)

The header fields — **Status**, **Due Date**, **Type**, **Value**, **Owner**, **Assignees**, **Visibility** — are all editable inline (Owner is read-only from here). Click **View Opportunity** to jump back to the original listing in Search or Leads, or **Open Chat** to start a [Sammy conversation](https://docs.samsearch.co/features/chat.md) scoped to this journey's documents.

**Value** shows your manually-set deal value if you've entered one, or the platform's own opportunity-value estimate (marked with "≈") if you haven't. You can clear a manual value at any time to fall back to the estimate.

**Notes** — a rich-text notepad saved automatically as you type:

* Type **@** to mention a teammate *or* a journey contact — both are searchable from the same menu
* Type **/** for slash commands: **`/task`** creates a real task on this journey without leaving the notepad, plus quick-inserts for the journey's due date, solicitation number, today's date, and any contact's name/email/phone

**Contacts** — store names, roles, phone, and email for anyone tied to this bid (contracting officers, teaming partners, internal SMEs). Each contact with an email gets one-click **compose email** and **schedule meeting** actions.

#### Comments

![Comment box on the Journey Overview page with multi-line text and @mention autocomplete](https://mintcdn.com/samsearch/hWjAYVbyKbUw6hpK/images/journey-hub/journey-overview-comments.png?fit=max\&auto=format\&n=hWjAYVbyKbUw6hpK\&q=85\&s=b30f878f01428ea67661ceec26ea9f29)

Post comments directly on a journey — the fastest way to loop in teammates without leaving it.

* Multi-line text, so you can leave detailed notes
* Type **@** to tag a teammate — they'll see it in their [Mentions tab](#my-tasks)
* Reply threads, and react to any comment with an emoji (a quick row of eight, or the full picker)

### Activity Log

![Collapsible Activity Log on the Journey Overview page showing status changes and field edits](https://mintcdn.com/samsearch/l7UUPFoe9cnssSs2/images/journey-hub/journey-overview-activity-log.png?fit=max\&auto=format\&n=l7UUPFoe9cnssSs2\&q=85\&s=ed6e8647815400b58bba62cb7cbe0c89)

A collapsible log tracks every change to a journey — stage moves, title/field edits, assignments, task changes, contact changes, and document uploads — filterable by action type and by member, so anyone joining the journey can see what's happened at a glance.

**Assignment History** appears once anyone has ever been unassigned from the journey, and groups bulk assignment changes into single, readable rows (e.g. "Jane assigned Alice, Bob, and Sam").

### Tasks

![Journey Tasks tab in Board view with To Do, In Progress, and Done columns](https://mintcdn.com/samsearch/zeNhOlOARkPzzRTv/images/journey-hub/journey-tasks-board.png?fit=max\&auto=format\&n=zeNhOlOARkPzzRTv\&q=85\&s=9e4e7818319867437a90e63748db6830)

The Tasks tab has its own **Board**, **Calendar**, and **Table** views, filterable by Priority, Due Date, and Assignee.

* **Statuses**: **To Do**, **In Progress**, **Done** — fixed, not customizable
* **Priorities**: **Low**, **Medium**, **High**
* Assign one or more teammates to any task
* Click a task to open its **task detail page** — full description, status/priority/due-date controls, and its own comment thread with the same @mention, reply, and emoji-reaction system used on the journey Overview. Unread mentions in a task's comments are highlighted, and the page scrolls to and flags the first unread one automatically.

> [!NOTE]
>
> Want to see all your tasks across every journey at once instead of one journey at a time? Use [**My Tasks**](#my-tasks) in the Journey Hub view switcher.

### Documents

Store every bid-related file inside the journey — solicitation attachments, drafts, past performance, certifications, and anything you upload.

* **Limits**: up to **50 MB per file**, **20 files per upload**
* **Accepted types**: `.pdf` `.doc` `.docx` `.xls` `.xlsx` `.pptx` `.csv` `.txt`

**Indexing status** — each document shows a badge while SamSearch processes it for AI search and chat context:

| Badge | Meaning |
| - | - |
| **Queued** / **Indexing...** | Waiting or actively being processed |
| **Indexed** | Ready — searchable and available to Sammy |
| **No Text** | The file has no extractable text (e.g. an unreadable scan) |
| **Too Large** | The file exceeded the size limit for indexing |
| **Failed** | Processing errored — use **Retry indexing** from the row menu |

> [!NOTE]
>
> **Where you upload a document changes what it feeds.** Documents uploaded to your **Company Profile** feed both Sammy chat and proposal generation across every opportunity. Documents uploaded only inside a single **Journey** are used for that journey's proposal and chat, but feed the Strategy [Insights](#strategy-insights) and compliance assessment less strongly than Company Profile documents do. If a capability statement or past-performance record is something you'll want referenced everywhere, put it in your Company Profile, not just one journey.

**Amendment Sync** — for **federal opportunities only**, SamSearch checks for new amendment attachments automatically each time you open the journey, and you can also click **Sync amendment** in the toolbar to check on demand. New attachments are added alongside your existing documents — nothing is replaced. This only works for journeys created from a live opportunity; a manually-created ("Upload" type) journey has no source listing to sync against.

> [!NOTE]
>
> Need a document that isn't attached to the opportunity at all — for example something only available through a FOIA or agency records request? Use **Request documents** or **Request records** on the opportunity page, or reach out through **Live Support**, and the SamSearch team will make the request for you, typically within **48 business hours**. See [Requesting missing documents](https://docs.samsearch.co/features/contract-overview/sled.md#requesting-missing-documents).

**Fill & Sign** — open any PDF or Word form from a document's row menu to fill it out and sign it directly in the browser, no printing required. [Full details are in Proposal Generation →](https://docs.samsearch.co/features/proposal.md#fill--sign)

### Compliance

![Empty Compliance Matrix state with Generate Outline and Create Manually options](https://mintcdn.com/samsearch/zeNhOlOARkPzzRTv/images/journey-hub/journey-compliance-empty.png?fit=max\&auto=format\&n=zeNhOlOARkPzzRTv\&q=85\&s=5e780b23326b93e1d6b3299693a5483d)

The Compliance tab holds a row-by-row requirements matrix for the opportunity.

**Build the matrix** by clicking **Generate Outline** (extracts requirements from the RFP/RFQ automatically as part of outline generation — see [Proposal Generation](https://docs.samsearch.co/features/proposal.md)) or **Create Manually** to add rows yourself.

![Filled Compliance Matrix with status, risk level, and response strategy columns](https://mintcdn.com/samsearch/zeNhOlOARkPzzRTv/images/journey-hub/journey-compliance-filled.png?fit=max\&auto=format\&n=zeNhOlOARkPzzRTv\&q=85\&s=c39b6aa098804843e27b410222c939c0)

Each requirement row has:

| Field | Values |
| - | - |
| **Compliance Status** | Compliant · Partial · Non-Compliant · TBD |
| **Risk Level** | Low · Medium · High · Critical |
| **Response Strategy** | Free text — how you'll address it |
| **Supporting Evidence** | Free text — where the evidence lives |

A new matrix starts entirely **TBD** — a background pass assesses each requirement against your company's documents shortly after generation and fills in a status automatically; you can override any AI assessment yourself. A **Compliance Rate** percentage at the top gives a quick read on bid readiness.

Click **Create Task** on any row to spin up a task pre-filled with that requirement's details, or **View source** to open the exact page and passage in the solicitation the requirement was extracted from.

If a solicitation amendment changes the requirements after your matrix already exists, use **Re-shred requirements** to see exactly what was added, changed, or removed — nothing updates until you review the diff and click **Apply**. Full detail on the reshred flow, and on Fill & Sign, is covered in our Help Center's "Compliance Matrix and Fill & Sign" guide.

### Strategy Insights

![Insights tab showing recommendation, win themes, risks, key dates, and contract snapshot](https://mintcdn.com/samsearch/zeNhOlOARkPzzRTv/images/journey-hub/journey-insights.png?fit=max\&auto=format\&n=zeNhOlOARkPzzRTv\&q=85\&s=a398cfba9b5d338c0acc26d35851d192)

Generated automatically alongside your outline, Insights is the one-screen capture-manager brief: when it's due, whether to bid and why, how to submit, and the key facts.

* **Our call** — a bid/no-bid recommendation with rationale, plus a win-probability read (high/medium/low)
* **Win themes** — the differentiators the AI thinks should anchor your proposal
* **Risks & how to handle them** — each paired with a suggested mitigation
* **Key dates, snapshot, format rules, and contacts** — set-aside, NAICS/PSC, place and period of performance, contract type, estimated value, and incumbent, pulled straight from the solicitation

If your company can't meet a stated set-aside or eligibility requirement, an **eligibility flag** appears at the top before anything else — this is meant to be the first thing you see before investing more time.

### AI Chat (Sammy)

Click **Open Chat** from the Overview tab to talk to Sammy with this journey's documents already in context — analyze the RFP, understand requirements, or get help drafting content. [Learn more about Sammy →](https://docs.samsearch.co/features/chat.md)

### Submit

Your pre-submission workspace, built on the same outline/proposal pipeline as everything above:

* **Bid Checklist** — every submission-logistics item (forms to fill, signatures, uploads, registrations), grouped into Prerequisites → Drafting → Forms & Pricing → Final Assembly, each linked back to the compliance requirements it satisfies
* **Proposal Outline** — the section-by-section structure the narrative will follow, editable before you generate
* **Generate Proposal** — produces the full draft from your outline, documents, and compliance data

[Learn more about Proposal Generation →](https://docs.samsearch.co/features/proposal.md)

## Visibility & Sharing

Journeys can be set to:

* **Shared** — visible to every member of your organization
* **Private** — visible only to you and anyone directly assigned

> [!NOTE]
>
> You can't switch a journey to **Private** while it still has active assignees — remove all assignees first. This prevents accidentally hiding a journey from people who are actively working on it.

## Deleting a Journey

From the journey's kebab menu (or the Table view's row/bulk actions), click **Delete**. You'll see a confirmation: *"This action cannot be undone and will permanently delete this journey and all its tasks."* There's no undo — the journey and every task, comment, document reference, and the compliance matrix are removed immediately. A deleted journey still counts toward historical totals in [Reports](https://docs.samsearch.co/features/reports.md), which can include it when **Include archived journeys** is on.

## Supported Opportunity Types

Journey Hub works with every opportunity type: Federal, SLED, Grants, Forecasts, Recompete, Subcontracting, DIBBS, GSA eBuy, Canada, and manually-created ("Upload") journeys.

## Team Collaboration

> [!NOTE]
>
> Team collaboration in Journey Hub needs more than one seat. Invite teammates from [Settings → Team & Organization](https://docs.samsearch.co/features/settings.md#team--organization) first.

Journey Hub is built for teams — every journey can be owned, assigned, and shared across your organization. This is a deliberate contrast with **Saved Opportunities**, which are private per login and never sync between teammates: if two people on the same team need to see the same pipeline, that's Journey Hub, not each person's individual saved list.

### Team members and roles

Inviting teammates, roles (Owner, Admin, Member), and individual member permissions such as **Edit Board Columns** and **Change journey visibility** are all managed in [Settings → Team & Organization](https://docs.samsearch.co/features/settings.md#team--organization).

### Assigning Journeys and Tasks

Each journey has an **Owner** and can have one or more **Assignees**. Use the **Owner** and **Assignee** filters to see your own pipeline, a specific teammate's, or the whole team's. Individual **tasks** within a journey can be assigned separately from the journey itself.

***

## Best Practices

1. **Start journeys from the opportunity, not from scratch** — this is the only way to get ongoing amendment tracking
2. **Use clear titles** — make each journey easy to identify at a glance
3. **Set due dates early** — allow time for review and revision, not just submission
4. **Break work into tasks** — specific tasks are easier to complete than vague to-dos
5. **Keep past performance and capability statements in your Company Profile**, not just a single journey, so every proposal and chat can draw on them
6. **Use Visibility settings** — keep sensitive journeys private; share the rest with your team
7. **Check My Tasks daily** — start your day there to see what's overdue, due today, and coming up this week across every active bid


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