# Leads

{% hint style="info" %}
User permission: CRM
{% endhint %}

{% hint style="info" %}
During your Phocas implementation, we often import your Contacts and Leads as a one-time process. However, you might want to re-import these items occasionally, for example, to update custom fields in bulk. You can’t do this task yourself, but you can contact your Customer Success Consultant to arrange for our Professional Services team to do it for you.
{% endhint %}

A lead does not belong to an account. A lead is different to a [contact](https://docs.phocassoftware.com/crm/contacts).

## View a list of all leads <a href="#manageleads-viewalistofallleads" id="manageleads-viewalistofallleads"></a>

Select the CRM menu button > **Leads**.

The **Leads** page displays all leads you have permission to view. From here, you can add new leads, or convert or delete existing ones.

{% hint style="info" %}
On the Leads page, the **convert** and **delete** options are available only in the desktop version. To convert leads in the mobile-friendly version, you need to access the individual lead's details.
{% endhint %}

{% columns %}
{% column %}

<figure><img src="https://4133978327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1DdwWAKI55yCxN4CVAUT%2Fuploads%2FkbcDwJIZzFIreAbcL0B8%2FScreenshot%202025-09-09%20at%2009.48.17.png?alt=media&#x26;token=1b524449-28ee-4491-be6c-edc0a3e71c5f" alt=""><figcaption><p>Desktop version</p></figcaption></figure>
{% endcolumn %}

{% column %}

<div align="left"><figure><img src="https://4133978327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1DdwWAKI55yCxN4CVAUT%2Fuploads%2FUvWb2YAUBNkGIaSYI7jP%2FScreenshot%202025-09-09%20at%2010.34.52.png?alt=media&#x26;token=d5faee3b-cc50-4836-986d-9716e379e534" alt="" width="76"><figcaption><p>Mobile-friendly version</p></figcaption></figure></div>
{% endcolumn %}
{% endcolumns %}

## Find a lead <a href="#manageleads-findalead" id="manageleads-findalead"></a>

On the **Leads** page, you can find a particular lead using the filter and search options, or by sorting the list.

{% tabs %}
{% tab title="Desktop version 2" %}

<div align="left"><figure><img src="https://4133978327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1DdwWAKI55yCxN4CVAUT%2Fuploads%2Feewjqpqrtn8Pj2r5zqH9%2FScreenshot%202025-09-09%20at%2010.49.36.png?alt=media&#x26;token=03c5fc6f-f170-45fc-85f2-542c8b13c7fd" alt="" width="375"><figcaption></figcaption></figure></div>

* **Active filter**: Switch between active and inactive leads.
* **Company filter**: Show leads from a specific company.
* **Job Title filter**: Show leads with a specific job title.
* **Owner filter**: Show only your leads or those owned by another user (with the appropriate permissions).
* **Team filter**: Show leads assigned to one of your teams.
* **Search box**: Find a lead by name (uses *is like* matching on the columns in the grid).
* **Column headings**: Click to sort data in ascending or descending order.

Filters remain active until you turn them off, so if you apply a filter and move away from the screen and then return, the filter will remain. To clear any filter you have applied, choose **Select none** from the dropdown list.&#x20;
{% endtab %}

{% tab title="Desktop version 1" %}

* Use the **Active** filter to switch between viewing active and inactive leads in the list. &#x20;
* Use the **Owner** filter to display only your leads or leads that belong to another user (that you have permissions to view).
* Use the **Team** filter to display leads allocated to a specific team to which you belong.
* Use the **Search** box to search for a specific lead by name. This performs an *is like* search on the name column.
* Click a column heading to sort data into ascending or descending order.&#x20;

Filters remain active until you turn them off, so if you apply a filter and move away from the screen and then return, the filter will remain. To clear any filter you have applied, select **All** from the dropdown list.&#x20;
{% endtab %}

{% tab title="Mobile" %}
To find the lead you requir&#x65;**,** type your search term into the box, such as a name or company, and any matching results will instantly be displayed.
{% endtab %}
{% endtabs %}

## Add a lead   <a href="#manageleads-addalead" id="manageleads-addalead"></a>

{% tabs %}
{% tab title="Desktop version 2" %}

* On the **Leads** page, select the **Add lead** button (blue plus).

<div align="left"><figure><img src="https://4133978327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1DdwWAKI55yCxN4CVAUT%2Fuploads%2FVfAm977ZUYnH0IFIwuK8%2FScreenshot%202025-09-09%20at%2010.58.56.png?alt=media&#x26;token=c037e219-18b7-4010-a7fe-55f4fb04f105" alt="" width="375"><figcaption></figcaption></figure></div>

* Enter the lead’s details as required (items marked with an asterisk \* are mandatory). See the [standard lead details table](#standard-lead-details) below to learn more about each item (field).&#x20;

<div align="left"><figure><img src="https://4133978327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1DdwWAKI55yCxN4CVAUT%2Fuploads%2FZmtBJmeHRfSaJCBVbISn%2FScreenshot%202025-09-09%20at%2013.14.14.png?alt=media&#x26;token=aadc60d2-0d70-4abd-90d5-75c47e243464" alt="" width="375"><figcaption></figcaption></figure></div>

* After completing the mandatory fields, select **Save**. This activates the **Activities** tab, where you can [add activities](https://docs.phocassoftware.com/crm/activities) to the lead's record.
* Select **Close** to return to the main **Leads** page.
  {% endtab %}

{% tab title="Desktop version 1" %}

* On the **Leads** screen, click **New**.

  <div align="left"><figure><img src="https://content.gitbook.com/content/1DdwWAKI55yCxN4CVAUT/blobs/AaCpDSF5jczJZodsbQzM/614476.png" alt="" width="217"><figcaption></figcaption></figure></div>
* Enter the lead’s details as required (items marked with an asterisk \* are mandatory). See the [standard leads details table](#standard-lead-details) below to learn more about each item (field).

  <div align="left"><figure><img src="https://content.gitbook.com/content/1DdwWAKI55yCxN4CVAUT/blobs/L3WPxOyqY7wYKMggaMt6/614474.png" alt="" width="272"><figcaption></figcaption></figure></div>
* Click **Save**. If successful a new tab displays, allowing you to [add activities](https://docs.phocassoftware.com/crm/activities) to the campaign. You can come back to this tab later.
* Click **Close**.
  {% endtab %}

{% tab title="Mobile" %}

<div align="left"><figure><img src="https://4133978327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1DdwWAKI55yCxN4CVAUT%2Fuploads%2Fp994qM8PxPDG7GtFq10i%2Faddnewleadcrmmobile.gif?alt=media&#x26;token=68c314e8-5a00-4895-8609-8bbd3425a16a" alt="" width="91"><figcaption></figcaption></figure></div>

* On the **Leads** page, select the **Add lead** button (blue plus).
* Enter the lead’s details as required (items marked with an asterisk \* are mandatory). See the [standard lead details table](#standard-lead-details) below to learn more about each item (field).&#x20;
* After completing the mandatory fields, select **Save**.
* Select **Close** to return to the main **Leads** page. When you select the newly created lead, you can now [add activities](https://docs.phocassoftware.com/crm/activities) to the lead's record by selecting the **Add activity** button.&#x20;
  {% endtab %}
  {% endtabs %}

#### **Standard lead details:**

<table><thead><tr><th width="186">Field</th><th width="135">Field type</th><th>Description</th></tr></thead><tbody><tr><td>Prefix</td><td>Dropdown list</td><td>The salutation of the lead. Choose from Dr, Mr, Mrs, Miss, Ms, Prof. </td></tr><tr><td>First Name</td><td>Free text</td><td>The first name of the lead. This field is mandatory.</td></tr><tr><td>Middle Name</td><td>Free text</td><td>Middle name (or initial) of the lead. </td></tr><tr><td>Last Name</td><td>Free text</td><td>Surname of the lead. This field is mandatory.</td></tr><tr><td>Company</td><td>Free text</td><td>Can be used to indicate which company the lead represents. Typically when a lead is converted, this would be the account field.</td></tr><tr><td>Job Title</td><td>Dropdown list</td><td><p>Typically this field will indicate the lead's area of responsibility, rather than their exact job title. For example, the job title of <em>Northern Region Sales Executive</em> could be simply recorded as <em>Sales</em>.</p><p>This is a customizable field that can be edited by administrators using<a href="../administration#edit-the-options-in-crm-dropdown-lists"> picklists</a>.</p></td></tr><tr><td>Owner</td><td>Dropdown list</td><td>May be used to identify the person who normally looks after this lead. Owners are CRM users. </td></tr><tr><td>Is Active</td><td>Y/N</td><td>Active leads typically include people who are potentially doing business with you. Inactive leads might no longer present an opportunity for future business. Rather than delete the entire lead and all the associated activities, it is often better to mark these leads as inactive. </td></tr><tr><td>Phone</td><td>Free text</td><td>Direct (landline) phone number of the lead.</td></tr><tr><td>Fax</td><td>Free text</td><td>Direct fax number of the lead.</td></tr><tr><td>Email</td><td>Free text</td><td>Email address of the lead.</td></tr><tr><td>Website</td><td>Free text</td><td>Typically the website of the lead's company</td></tr><tr><td>Cell</td><td>Free text</td><td>Cell phone (mobile phone) number of the lead.</td></tr><tr><td>Contact Method</td><td>Dropdown list</td><td>Typically used to record the way that particular person prefers to be contacted – e.g. via phone or email. This is a customizable field that can be edited by administrators using<a href="../administration#edit-the-options-in-crm-dropdown-lists"> picklists</a>.</td></tr><tr><td>Street/city</td><td>Free text</td><td>Street address and city of the lead. </td></tr><tr><td>State</td><td>Free text</td><td>State in which the lead is based, if applicable.</td></tr><tr><td>Postcode</td><td>Free text</td><td>Zip or Postcode of the lead.</td></tr><tr><td>Country</td><td>Free text</td><td>Country the lead is located in. </td></tr><tr><td>Is Mail Address</td><td>Y/N</td><td>Choose ‘Yes’ if the mail address is the same as the street address. Choose ‘No’ if the mail address is different, and enter in the details in the section below. </td></tr><tr><td>Street/city</td><td>Free text</td><td>Postal street address (or PO box) and city of the lead.  </td></tr><tr><td>State</td><td>Free text</td><td>Postal state of the lead, if applicable.</td></tr><tr><td>Postcode</td><td>Free text</td><td>Postal Zip or Postcode of the lead.</td></tr><tr><td>Country</td><td>Free text</td><td>Postal country the lead is located in.</td></tr><tr><td></td><td>Custom</td><td>Any field not listed in this table is a custom field. Administrators can create custom fields, typically from data that already exists in your ERP or other systems. </td></tr></tbody></table>

## View and edit a lead <a href="#manageleads-viewandeditalead" id="manageleads-viewandeditalead"></a>

{% tabs %}
{% tab title="Desktop version 2" %}

1. On the **Leads** page, select the lead name (blue link) to open the lead record.
2. On the lead record:
   * **Lead** tab: View and edit the lead’s details, such as its name, owner, and address, and assign the lead to another owner (CRM user responsible for communicating with that lead).
   * **Activities** tab: View and edit the activities assigned to the campaign, or delete (remove) activities from the campaign. &#x20;
3. Select **Save** to apply your changes, then **Close** to return to the main **Leads** page.

<div align="left"><figure><img src="https://4133978327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1DdwWAKI55yCxN4CVAUT%2Fuploads%2FyJlYr95hViMzBEVergja%2FeditleadsCRM.gif?alt=media&#x26;token=31e09b35-bed9-453a-b391-65100a313435" alt="" width="375"><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Desktop version 1" %}

* On the **Leads** page, select the lead name (blue link) to open the lead record.
* On the lead record:
  * **Lead** tab: View and edit the lead’s details, such as its name, owner, and address, and assign the lead to another owner (CRM user responsible for communicating with that lead).
  * **Activities** tab: View and edit the activities assigned to the campaign, or delete (remove) activities from the campaign. &#x20;
* Select **Save** to apply your changes, then **Close** to return to the main **Leads** page.
  {% endtab %}

{% tab title="Mobile" %}

* On the **Leads** page, select a lead name to open its record.

  * **Lead details tab** – View and edit details such as name, owner, and address. Reassign the lead to another owner (the CRM user responsible for communication). Add activities or take direct actions, such as calling, messaging, or emailing the contact.
  * **Activities tab** – Add new activities, or view and edit existing ones linked to the lead.

  Select **Save** to apply your changes, then **Close** to exit. To return to the main **Leads** page, select the back button (<).

<div align="left"><figure><img src="https://4133978327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1DdwWAKI55yCxN4CVAUT%2Fuploads%2FCyor8jrfKGuHkUak4zYV%2FeditleadsmobileCRM.gif?alt=media&#x26;token=d9999eeb-2dd4-454e-83a5-b636f020c191" alt="" width="91"><figcaption></figcaption></figure></div>
{% endtab %}
{% endtabs %}

## Convert a lead into a contact <a href="#manageleads-convertaleadintoacontact" id="manageleads-convertaleadintoacontact"></a>

Typically, when the lead becomes a customer, you can convert the lead records into contacts. Contacts, unlike leads, cannot exist in isolation in CRM and must be assigned to an account.&#x20;

When you convert a lead to a contact, the lead disappears from the list on the **Leads** screen and displays in the list on the **Contacts** screen instead. Any activities assigned to the lead are retained.

{% hint style="info" %}
Prerequisite: [Check the account is in CRM](https://docs.phocassoftware.com/crm/accounts). If not, [add a new account](https://docs.phocassoftware.com/crm/accounts#addanddeleteaccounts-addanaccount).
{% endhint %}

{% tabs %}
{% tab title="Desktop version 2" %}

1. On the **Leads** page, select the menu button (three dots) at the end of the contact’s row, then choose **Convert**. Alternatively, select the lead name (blue link) to open the lead record.<br>

   <div align="left"><figure><img src="https://4133978327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1DdwWAKI55yCxN4CVAUT%2Fuploads%2FGc4kvTPo4b2ZulA7CBBT%2FScreenshot%202025-09-10%20at%2015.37.32.png?alt=media&#x26;token=a8c50107-de62-4835-831a-1624d7f70114" alt="" width="375"><figcaption></figcaption></figure></div>
2. On the **Lead** tab, select the **Convert** button.
3. Select the account you wish to add the lead to, and select **Save.**

<div align="left"><figure><img src="https://4133978327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1DdwWAKI55yCxN4CVAUT%2Fuploads%2F6mjxslhFfBE8Y4SkWbEU%2FconvertleadCRM.gif?alt=media&#x26;token=fa7c478c-d235-4dd8-bd3f-48e2050a9af2" alt="" width="375"><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Desktop version 2" %}

1. On the **Leads** screen, select the lead row (it turns blue) and click **Convert**.

   <div align="left"><figure><img src="https://content.gitbook.com/content/1DdwWAKI55yCxN4CVAUT/blobs/l3RnnS6BwAUDirGvV2EA/614470.png" alt="" width="375"><figcaption></figcaption></figure></div>
2. Select the appropriate account and click **Save**.
   {% endtab %}

{% tab title="Mobile" %}
On the **Leads** page, select a lead name to open its record.

1. On the **Lead** tab, select **Convert**.
2. Choose the account to add the lead to, then select **Convert**.

The lead is now converted into a contact. To locate the contact, select **Contacts** at the bottom of the screen to navigate to the **Contacts** page and scroll or search by name.

<div align="left"><figure><img src="https://4133978327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1DdwWAKI55yCxN4CVAUT%2Fuploads%2FKHYbiKSq3rJbRbM8h8S5%2FconvertleadCRMmobile.gif?alt=media&#x26;token=6cf9a55a-8fc7-48e2-8539-585d87580a5c" alt="" width="91"><figcaption></figcaption></figure></div>
{% endtab %}
{% endtabs %}

## Delete a lead <a href="#manageleads-deletealead" id="manageleads-deletealead"></a>

{% hint style="info" %}
Leads can only be deleted in the **desktop version** of CRM.
{% endhint %}

If you do not have delete permissions, the **Delete** button might not display or you might see a message at the top of the screen indicating you do not have permission to delete. Talk to your administrator about your permissions. Deleted items can be restored by administrators.

* On the **Leads** page, select the menu button (three dots) at the end of the contact’s row, then choose **Delete**.

<div align="left"><figure><img src="https://4133978327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1DdwWAKI55yCxN4CVAUT%2Fuploads%2FfmJsf4eFw0RsNk9IMutb%2FScreenshot%202025-09-10%20at%2015.27.52.png?alt=media&#x26;token=05d0d7d5-1b75-48e5-b3fe-42722deb5458" alt="" width="375"><figcaption></figcaption></figure></div>
