Associating Leads through Custom Field Sets

Custom Field Sets allow you to create a group of fields to capture data on a lead or an activity. If you’re new to the feature, see Custom Field Sets.
This article shows you how to use custom field sets to associate individual leads in your LeadSquared account.


Example Use Cases

Using this feature you can associate leads who are –

  • Primary and secondary applicants on insurance products
  • Applicants and guarantors on loans
  • Students and guardians for education applications
  • Patients and emergency contacts on healthcare applications



  • You must be an administrator user to set up the custom field set functionality. Once set up, all users can use it.
  • Lead
  • If you’re unfamiliar with this feature, first see Custom Field Sets.


How it Works

You can associate multiple leads to an activity through a custom field set –

  1. Create a custom field set with one or more fields of ‘lead’ type. Configure the lead type (see the table below for details) field to allow access to*
    • Accessible Leads
    • All leads
  2. Associate the custom field set with an activity.
  3. When the activity is being posted through a regular or dynamic form, the option to associate a lead will now appear.

Note: While creating/editing a custom field set, ensure that only the Activity Integration checkbox is selected. If the ‘Lead Integration’ checkbox is selected, the option to create a field of lead type will not appear in the next step.

activity integration CFS

Accessible LeadsUsers will only be able to search for and associate leads to which they have access (as configured through permission templates and/or sales groups).
All LeadsUsers will be able to search for and associate all leads available in the LeadSquared account, regardless of permissions assigned through permission templates and/or sales groups.

Note: Users will only be able to search for and associate the leads within the context of the activity form. They will still not be able to view the lead details page.



Since the procedure varies for each use case, the following sections demonstrate an easy to follow example –

An education application requires information of both a student and a guardian. The education application is created as an activity in LeadSquared. Here are the steps required to associate the leads through custom field sets –

  1. While creating/editing a custom field set, add a field of ‘lead’ type.
  2. Associate the custom field set with the education application activity.
  3. Either
    • Post the activity through the default activity form that appears in Manage Activities or on the lead details page.
    • Create a dynamic form to capture the activity (Optional).
  4. When the application is being filled
    1. The activity will be posted against the student.
    2. The guardian can be selected from the lead type field in the custom field set (step 1).

The two leads will now be associated as student and guardian in the context of the education application activity.


Add a Lead Type Field to a Custom Field Set

While creating or editing a custom field set –

  1. Select the Activity integration checkbox.
  2. Add a lead type field.
  3. Click the settings settings icon, then choose Accessible Leads or All Leads.

For more details on how to create or edit a custom field set, see Custom Field Sets.

CFS adding a lead type field


Associate the Custom Field Set with the Activity

Now add the custom field set to the required activity. For the detailed procedure, see Adding Custom Field Sets to Activities.

Here we’ve added the custom field set to an ‘Education Application’ activity –

custom field sets with lead field


Post the Activity Through a Default Activity Form

You can now post the activity from the Manage Activities page or the Lead Details page. For detailed information, see How to Post Activities.

The Lead Name field lets you search for a lead using quick search parameters. Click the Add button to associate the lead.

Note: By default, First Name, Last Name, Email Address, and Phone are displayed in the quick search results. To customize the fields you want to display, contact us at

associate lead through activity

If you can’t find the lead you’re looking for, use the Add New option that appears under the lead field.

add new lead to associate

You’ll be directed to the Add New Lead form by default. For details, see How to Customize Lead Forms. Note that the forms mentioned here are the basic lead forms available on your settings page (My Profile>Settings>Customization>Lead Forms). Dynamic forms are discussed below.


Create a Dynamic Form to Capture the Activity

You also have the option of creating a dynamic form to capture the activity. For details, see How to Create a Form.

If you can’t find the lead you’re looking for, the Add New option will appear under the lead field.

Lead association in dynamic forms

You can customize the Add New option to display a sub-form of lead type –

  1. Select the Lead Name field.
  2. On the right-pane, under Field Properties, under Configure Sub-Form for Lead Creation, click Create New Sub-Form.
  3. Now create the sub-form with the lead fields you require (see the sub-form section in How to Create a Form).

create sub form for lead association


View and Filter Activities with Associated Leads

Once you post activities with associated leads, you can view them on the Manage Activities, Lead Details and Smart Views pages.

Note: Custom field sets shown below may be displayed differently for ESS tenants.


Manage Activities

On the Manage Activities page, you can view the associated lead in the grid. Clicking the lead name will direct you to the lead details page (provided you have access, see FAQs for more information).

Manage activities associated lead

If you don’t see the lead column at all on the grid, click the column select column icon customization icon and select the lead column.

manage activities column customization


Lead Details

You can also view and edit the activity from the Lead Details page.

lead details activity example


Smart Views

Similarly, the activities will be visible from your activity-based smart views tabs.

activities with associated leads in smart views


Advanced Search

Lead fields within the custom field set will be available for filtering through advanced search.

CFS lead fields in CFS



Here are some frequently asked questions about this feature –

1. I’m searching for a certain lead that is not showing up on the lead association search. When I click ‘Add New’ and try to create a lead, I encounter a ‘Duplicate Lead Found’ error. Why is this happening?

You don’t have permission to view the lead, therefore it isn’t showing up on the search. However, the lead does exist in the system so you can’t enter the same email address and create a duplicate lead.

If you set the properties of the lead field within the custom field set to All Leads, you can avoid this issue.

CFS lead type field configurations

2. I set the lead field properties within the custom field set to allow access to All Leads. Does this mean, that a user can see all leads in the system regardless of the permission templates and sales groups?

No. When you set the lead field properties to allow access to all leads, the leads will only appear in the quick search option. Users will still not be able to navigate to the lead details page for these leads. You can also configure which fields you want to display in the quick search results by contacting us at

associate lead through activity


3. I posted an activity against a lead. The admin user in my account associated a lead to the activity to which I don’t have access. Will I be able to view the associated lead?

No, if you try and view the associated lead through Manage Activities or Smart Views, you’ll receive a ‘No Access’ notification.


Any Questions?

Please feel free to leave comments if you have additional questions. It would really help us understand your issues better.

Was this Helpful?

Notify of
Inline Feedbacks
View all comments