# Work an opportunity

> Open an opportunity to read its header, contacts, organizations, impact, and tasks, follow its Activity tab, and use the Actions menu.

## Before you start

- An opportunity is a project your team is pursuing. The UI mostly calls it
  "opportunity," though some panels, dialogs, and the pipeline board say
  "project" instead. They mean the same thing.
- There's no **Opportunities** item in the sidebar. You reach an opportunity's
  detail page from a card on a pipeline's board or table, from a linked contact
  or organization, from a response that's been connected to it, or by promoting
  a response into a new opportunity (see [Review a
  response](https://kb.incenti.co/responses/review-a-response.md)). The breadcrumb at the top reads
  **Pipelines**, then the name of the pipeline the opportunity sits in (when it
  has one), then the opportunity's name.
- The **Actions** button (**Edit opportunity**, **Update metrics**, **Request
  responses**, **Generate form link**, and **Delete opportunity**) is shown only
  to **account admins**. Members can read and work the whole page (contacts,
  metrics cards, tasks, notes, documents) but never see that button. See [Roles
  and permissions](https://kb.incenti.co/getting-started/roles-and-permissions.md).

## Steps

_Screenshot: An opportunity's Overview tab: the Summary card with Owner, Status, Description, Industries, and Tags; the Details card with Start and End Date; the Contacts card with a primary contact; the four Economic Impact cards; and the top of the Tasks table._

### Read the header

The card at the top of the page shows the opportunity's name, its pipeline stage
as a colored pill, and its type (**Lead**, **RFI**, or **Project**). Below that
come the key facts: the **Owner** ("Unassigned" when nobody owns it), the start
and end dates (a missing one reads "Not set"; the dates are left out when
neither is set), the number of jobs when Total Jobs has a value, and the capital
investment in short form, such as "$850M capital investment". The opportunity's
tags are assigned from this card too.

The stage pill is the opportunity's pipeline stage: the column its card sits in
on its pipeline board, in that column's color. It isn't a separate field. Each
column has a category (Active, Inactive, or Closed) set on the pipeline; see
[Opportunity statuses](https://kb.incenti.co/contacts-and-pipeline/opportunity-statuses.md) for how stages, categories, and
Won/Lost outcomes work.

To change the stage, move the card: drag it to another column on the board, or
use the card's **⋮** → **Move to another pipeline** and pick the column there.
See [Pipelines](https://kb.incenti.co/contacts-and-pipeline/pipelines.md).

### Read the About card

Under the **Overview** tab, the **About** card shows the **Description** ("No
description" when there isn't one), the opportunity's **Industries**, and the
date it was **Created**. Owner, stage, and tags live in the header instead.

### Review Details and add custom fields

The **Details** card shows the opportunity's **Start date** and **End date**
(when either is set), plus any custom fields you've added. Click **Add field**
to open the **Add custom field** panel, enter a **Field name** and a **Value**,
and click **Add field** at the bottom. Hover over a field to get **Edit** and
**Delete**; editing opens the **Edit custom field** panel, with **Save changes**
at the bottom.

### Manage contacts

The **Contacts** card lists the people linked to this opportunity, with a count
beside the title. Click **Add** (or **Add contact** when the card is empty) to
open the **Add project contact** panel ("Link an existing contact or create a
new one for this project"). Choose **Select existing** and search with "Search
contacts", then click **Add contact**, or choose **Create new** to make a
brand-new contact in the same panel and click **Create contact**. On an existing
row, open **Contact actions** to **Set as primary** (a
**Primary** badge appears next to that contact, and you'll see "Primary contact
updated") or **Remove** it from the opportunity ("Contact removed from
project").

The first contact you add is _not_ made primary automatically, so set one yourself
if you want the card to show it.

> **Note:** Promoting a response into a new opportunity doesn't copy the respondent into this
> card. If you want the person who submitted the form listed here, add them with
> **Add contact**.

### Manage organizations

The **Organizations** card sits directly under the **Contacts** card and lists
the organizations linked to this opportunity, with a count beside the title.
Admins and members both see it and can use it; it isn't behind the **Actions**
button.

When nothing is linked, the card reads "No organizations on this opportunity
yet" with an **Add organization** button. Once there's at least one, the card
header has an **Add** button instead. Either opens the **Add project
organization** panel ("Link an existing organization or create a new one for
this project"), which has two options:

- **Select existing**: search with "Search organizations", which matches the
  organization's name or domain. The list offers organizations from your
  **Organizations** tab that aren't already linked; when there are none you'll
  see "No organizations available to add", or "No organizations match your
  search". Pick one and click **Add organization**; you'll see "Organization
  added to opportunity".
- **Create new**: the same form as **New organization** on the Contacts page
  (**Organization name** and the optional fields, including **Owner**). Click
  **Create organization** to save. That creates the organization and links it, with
  "Organization created and added to opportunity". If the organization was
  created but the link failed, the message is "Organization created, but failed
  to add it to the opportunity", and you'll find the new organization on the
  **Organizations** tab.

Each linked organization shows its name (a link to the organization's page), its
domain (opens the website in a new tab) and phone when set, and a **Primary**
badge when it's the primary one. Open **Organization actions** to **Set as
primary** (not shown on the organization that's already primary; you'll see
"Primary organization updated") or **Remove** ("Organization removed from
opportunity").

Like contacts, the first organization you add is _not_ made primary
automatically.

Removing an organization only unlinks it from this opportunity; the organization
itself stays on your **Organizations** tab. Linking an organization does not
link its contacts; add people on the **Contacts** card separately.

### Track economic impact

**For economic development organizations:**

Four cards in a row below the About, Details, Contacts, and Organizations cards
track the deal's projected impact: **Economic Impact** (labeled
"Auto-calculated"), **Total Jobs**, **Average Salary**, and **Capital
Investment**. Click any of the three editable cards to open the **Update
economic impact** panel, where you update **Total jobs**, **Average salary**,
and **Capital investment** at once and click **Save changes**; saving
recalculates Economic Impact.

Economic Impact is **Total Jobs × Average Salary + Capital Investment**. It stays
blank (a dash) until _both_ Total Jobs and Average Salary have values: capital
investment on its own isn't enough to produce a figure. Amounts use the
opportunity's currency, falling back to your account's currency, then US
dollars.

**For site selectors:**

The Economic Impact, Total Jobs, Average Salary, and Capital Investment cards are
shown only on economic development organization accounts. On a site selection
account the Overview tab goes straight from the About, Details, Contacts, and
Organizations cards to your account's custom metric cards and the Tasks card.

### Read the custom metric cards

If your account has defined custom metrics for opportunities, a row of cards
below the Contacts and Organizations cards shows one card per metric: the
metric's display name with its current value, formatted as a number, an amount,
a percentage, text, or true/false. A metric with no value yet shows a dash.

Account admins update them with **Actions** → **Update metrics**, which opens
the **Update metrics** panel ("Update the custom metric values for this
opportunity"). It lists every metric your account has defined and gives each one
a **Clear value** (×) button; click **Save changes** when you're done. If no
metrics exist yet, the panel says "No metrics have been defined for this account
yet" and points you to your account administrator. See
[Custom metrics](https://kb.incenti.co/account/custom-metrics.md) for how the definitions are created.

### Review connected properties

When responses linked to this opportunity have properties attached, a
**Properties** card appears above the Tasks table with a map and the count of
properties connected to this opportunity's responses. The card only shows for
accounts that have the properties module turned on, and only when there's at
least one connected property.

### Manage tasks

The **Tasks** card lists the tasks tied to this opportunity, with a **Search
tasks** box and **Add task** to create one. **Add task** opens the task panel
on the right with **Project (optional)** already set to this opportunity; the
panel also has an **Organization (optional)** picker. The **My tasks** page in the sidebar lists tasks from all your
projects, and no email or reminder is ever sent for a task. See
[Tasks on an opportunity](https://kb.incenti.co/contacts-and-pipeline/tasks.md) for the fields, defaults, notifications, and
the "Incenti AI" rows you may see on older opportunities.

### Add notes

The **Notes** card, below the Tasks card, works the same way here as it does on a contact or
organization page; see [Add notes to contacts, organizations, and
opportunities](https://kb.incenti.co/contacts-and-pipeline/notes.md) for the full picture of adding, linking, editing, and
removing notes. Adding a note here notifies the opportunity's owner.

### Follow the Activity tab

The **Activity** tab is the second tab, after **Overview**, and every account
sees it. Its **Activity** card ("What has happened on this opportunity") lists
what has happened on the opportunity, newest first, with how long ago it
happened next to each entry (hover over the time for the exact date and time).
Entries include:

- who created the opportunity, and the stage it started in
- who moved it from one stage to another ("moved this opportunity from **X** to
  **Y**")
- notes added, with the note's title
- emails logged or linked to it
- tasks added and completed
- forms submitted by respondents

An entry made by you shows your name; one made by the in-app agent shows your name followed by
"via Agent"; one made by Incenti or the system shows "Incenti". Entries loaded
when your data was imported also say "Imported", or "Imported from" and the
source, after the time. Click **Load more** at the bottom for older entries.
With nothing recorded yet, the tab reads "No activity yet". The tab is read-only:
add notes from the **Notes** card on the **Overview** tab.

### Work the Responses, Documents, Incentives, and Emails tabs

Each tab shows a count when it has anything in it.

- **Responses** lists the form responses connected to this opportunity. Each row
  shows the form, its status, the submitter, and when it was submitted, and
  opens the response with a link back here. Once any of them has been scored, a
  **Score** column shows each response's percentage; hover over it for the
  per-criterion breakdown. **Compare responses** at the top of the card opens
  every response to one form side by side (a menu lists the forms when there's
  more than one); see [Compare responses side by
  side](https://kb.incenti.co/responses/compare-responses-side-by-side.md). Before anything is
  connected it reads "No form responses yet" and "Form submissions will appear here"
  Open [Review a response](https://kb.incenti.co/responses/review-a-response.md) for what you can do
  from there.
- **Documents** lists files uploaded to this opportunity **plus every document
  attached to a response connected to it**, with an **Upload document** button
  and columns for title, description, type, uploader, and upload date. That's why
  files you never uploaded here can appear in the list.
- **Incentives** only appears once your account's Compliance module is turned on;
  it doesn't show for every account. When it's available, it's where you record
  and track incentive awards tied to this opportunity.
- **Emails** lists the logged email threads linked to this opportunity. When your
  account has a logging address, a **Log an email** button also sits next to
  **Actions** at the top of the page. See [Log an email to a contact or
  organization](https://kb.incenti.co/contacts-and-pipeline/log-an-email.md) and [Find and manage logged
  emails](https://kb.incenti.co/contacts-and-pipeline/find-and-manage-logged-emails.md).

### Use the Actions menu

Account admins click **Actions** at the top of the page for:

- **Edit opportunity**: opens the **Edit opportunity** panel ("Update the
  opportunity information") to update the **Project Name**, **Description**,
  **Start date**, **Due date**, and **Owner**, then click **Save changes**. To
  change the stage, move the card on the pipeline instead.

- **Update metrics**: your account's custom metric values for this opportunity,
  described above.

- **Request responses**: emails a form request to contacts and, for anyone not
  already in your CRM, adds them as contacts first. The dialog opens with a
  "Need the right format?" callout and a **Template** button that downloads the
  file to start from. See [Request responses from
  contacts](https://kb.incenti.co/forms/request-responses-from-contacts.md) for the whole flow and what
  recipients receive.

  _Screenshot: The Request Responses dialog with a Select Form dropdown and Search Contacts field, plus Upload CSV and Add Manually options._

- **Generate form link**: see below.

- **Delete opportunity**: asks you to confirm first with **Delete opportunity**
  or **Cancel**.

_Screenshot: The Actions menu open on an opportunity's detail page, showing Edit Opportunity, Update Metrics, Request Responses, Generate Form Link, and Delete Opportunity._

> **Warning:** Two known issues in this menu:
>
> **Due date isn't saved by Edit opportunity.** The panel shows a **Due date**
> field, but the value is dropped when you click **Save changes**; the opportunity
> keeps whatever due date it already had. Today a due date can only be set when
> the opportunity is first created, from a pipeline board's **New opportunity**
> panel.
>
> **Delete opportunity reports a failure that didn't happen.** After you confirm,
> the opportunity _is_ deleted, but the page stays where it is and shows "Failed to
> delete opportunity". Go back to **Pipelines** and you'll see it's gone. Both are
> fixes we have queued.

### Generate a form link

**Generate form link** gives you a public link to a form that is pre-tied to this
opportunity, so any response submitted through it is connected here
automatically. Pick a form under **Select Form**, then click **Copy form link**
(or the copy icon next to the link itself); you'll see "Link copied to
clipboard!". Nothing is emailed; you share the link yourself.

_Screenshot: The Generate Form Link dialog with its Select Form dropdown, the generated form link, and the Copy Form Link button._

Before copying, we check that the form is actually ready to receive answers:

- **Blockers** stop the copy: the form isn't Active (it's still a draft, or it's
  been closed or archived), or it has no fields yet. You'll see "Resolve the
  following before sharing this form link:" and have to fix the form first.
- **Warnings** don't: if the form doesn't capture a contact, you'll see "You can
  copy now, but you may want to address these first:" with a **Copy anyway**
  button. Responses submitted through a form with no contact capture arrive
  without a contact attached.

## How an opportunity connects to everything else

- **Responses** connect through **Request responses**, **Generate form link**,
  **Connect** on a response's own page, or by promoting a response into a new
  opportunity.
- **Documents** are either uploaded on the **Documents** tab or inherited from a
  connected response.
- **Contacts** are linked by hand on the **Contacts** card; nothing links them
  for you.
- **Organizations** are linked by hand on the **Organizations** card, the same
  way as contacts.
- **Properties** only arrive through a connected response that has properties
  attached.
- **Programs** are never linked to an opportunity directly; the connection is an
  incentive award, which needs the Compliance module.
- **Tasks** and **notes** are created on the opportunity itself; a note can also
  be attached to contacts and organizations at the same time.

## Who gets notified

These are in-app notifications in the bell only. There's no email for any of
them, and you're never notified about your own action:

- **Opportunity assigned**: the new owner, when an opportunity is created with
  an owner or reassigned to them.
- **Status updated**: the owner, when someone moves the opportunity to another
  column or into another pipeline. Creating an opportunity doesn't send it.
- **New note**: the owner, when someone adds a note to the opportunity.
- **Document uploaded**: the owner, when a document is attached.
- **New task assigned** / **Task completed**: see [Tasks on an
  opportunity](https://kb.incenti.co/contacts-and-pipeline/tasks.md).

See [Notifications and the bell](https://kb.incenti.co/getting-started/notifications-and-the-bell.md).

## What happens next

- Moving the card to another column changes the stage pill in the header straight
  away, and adds a "moved this opportunity" entry to the **Activity** tab.
- Sending a response request emails each recipient a link to the selected form.
  Nothing appears on the **Responses** tab until a recipient actually opens the
  form and submits it. The submission then also shows on the **Activity** tab.
- Generating a form link doesn't send anything. It's a link you copy and share
  yourself. Any response submitted through it is connected to this opportunity
  the same way a response request's is.
- Deleting an opportunity hides it from pipelines and lists. Despite the error
  toast, the delete has already gone through.

## Common questions

**Q: I don't have an Actions button on my opportunity. Where is it?**
A: **Actions** is shown only to account admins. Members can still edit the
Details card, add contacts, tasks, notes, and documents, but editing the
opportunity itself, updating metrics, requesting responses, generating a form
link, and deleting are admin-only. Ask an admin on your account, or ask them to
make you one.

**Q: I set a Due date in Edit opportunity and it didn't stick.**
A: That's a known bug: the **Edit opportunity** panel drops the **Due date** on
save. A due date can currently only be set when the opportunity is created from a
pipeline board's **New opportunity** panel. We're fixing it.

**Q: Deleting said "Failed to delete opportunity" but the opportunity is gone.**
A: Also a known bug. The delete succeeds; only the message is wrong. Go back to
**Pipelines** and refresh. The opportunity won't be there.

**Q: Why is Economic Impact blank when I've entered capital investment?**
A: Economic Impact is Total Jobs × Average Salary + Capital Investment, and it
stays blank until both **Total Jobs** and **Average Salary** have values. Fill in
those two and the figure appears.

**Q: There are documents on the Documents tab that I never uploaded here.**
A: The tab merges documents uploaded to the opportunity with documents attached
to any response connected to it, so files sent in by a respondent show up here
too.

**Q: Where did the Status dropdown in Edit opportunity go?**
A: Status is now the opportunity's pipeline stage, so it's changed by moving the
card on the board (or with **Move to another pipeline**) rather than in the
panel. The stage pill in the page header shows whichever column the card is in.

**Q: Where did the Summary card go?**
A: It's now the header at the top of the page plus the **About** card. The header
holds the stage pill, **Owner**, dates, and tags; **About** holds the
**Description**, **Industries**, and **Created** date.

**Q: Where do I see what happened on an opportunity?**
A: Open the **Activity** tab. It lists stage moves, notes, logged emails, tasks
added and completed, and form submissions, newest first.

**Q: I linked an organization but none of its contacts appeared on the Contacts
card.**
A: Organizations and contacts are linked separately. Add the people you want with
**Add** on the **Contacts** card.

**Q: I don't see an Incentives tab on this opportunity. Why not?**
A: The Incentives tab only shows up once your account's Compliance module is
enabled. If you believe it should be on, check with your account administrator.

## Related

- [Opportunity statuses](https://kb.incenti.co/contacts-and-pipeline/opportunity-statuses.md)
- [Tasks on an opportunity](https://kb.incenti.co/contacts-and-pipeline/tasks.md)
- [Pipelines](https://kb.incenti.co/contacts-and-pipeline/pipelines.md)
- [Contacts and organizations](https://kb.incenti.co/contacts-and-pipeline/contacts-and-organizations.md)
- [Find an opportunity, its stage, and its economic impact](https://kb.incenti.co/contacts-and-pipeline/find-an-opportunity.md)
- [Custom metrics](https://kb.incenti.co/account/custom-metrics.md)
- [Request responses from contacts](https://kb.incenti.co/forms/request-responses-from-contacts.md)
- [Review a response](https://kb.incenti.co/responses/review-a-response.md)
