---
title: Add From CRM – Custom Results Display & Custom Filter
description: SFDC, Salesforce, Dynamics, CRM, Filters
---

[Skip to content](https://nexusengage.com/help/add-from-crm-custom-results-display-custom-filter#main-content)

English

Show submenu for translations

![fb2acfcb-b621-467c-ac7f-d5d4beee378d-1](https://nexusengage.com/hs-fs/hubfs/fb2acfcb-b621-467c-ac7f-d5d4beee378d-1.png?width=200&height=53&name=fb2acfcb-b621-467c-ac7f-d5d4beee378d-1.png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [Nexus Website](https://nexuscenter.io/)

[Nexus Website](https://nexuscenter.io/)

 What are you looking for?

- There are no suggestions because the search field is empty.

1. [Nexus Help Center](https://nexusengage.com/help)
2. [Sales Enablement Hub](https://nexusengage.com/help/sales-enablement-hub)
3. [Dynamics Application](https://nexusengage.com/help/sales-enablement-hub#dynamics-application)

# Add From CRM – Custom Results Display & Custom Filter

## The Add From CRM – Custom Results Display & Custom Filter Fields feature enhances the Add From CRM experience by allowing administrators to configure custom filter fields and control how CRM search results are displayed when users add records from connected CRM systems. This capability improves data relevance, usability, and consistency when searching and selecting CRM records from within the platform. What’s New Introduction of an Admin configuration screen for Add From CRM field mappings Support for custom filter fields tied directly to CRM data types Configurable results display columns in the Add From CRM modal Improved validation to ensure CRM field compatibility Consistent behavior across Salesforce and Microsoft Dynamics

#### **Functional Summary**

The feature allows administrators to:

- Define which CRM fields appear as filters in Add From CRM
- Control how CRM records are displayed in search results
- Ensure filters align correctly with CRM field types
- Provide end users with a more targeted and reliable CRM search experience

End users benefit from:

- Faster searches
- Cleaner, more relevant results
- Reduced errors during CRM record selection

---

#### **Key Capabilities**

 

 

 

| **Capability**   | **Description**   |
| --- | --- |
| Custom Filter Fields | Admins can define filters based on mapped CRM fields |
| Custom Results Display | Control which CRM fields appear as result columns |
| CRM Field Validation | Enforced matching between filter type and CRM data type |
| Multi-CRM Support | Works with Salesforce and Microsoft Dynamics |
| Admin-Only Configuration | End users cannot modify filter logic |

 

 

 

---

#### **Configuration & Administration**

### Access Requirements

- Admin privileges required
- Active CRM integration (Salesforce or MS Dynamics)

---

### **Step-by-Step: How to Configure Custom Filters**

1. Navigate to **CRM Request Configuration**
2. Select a CRM entity:
   
     - Account
     - Contact
     - Opportunity
3. Select The CRM Instance
4. Open the **Filters** tab
5. Review available CRM fields (read-only list)
6. For each field:
   
     - Enable **Visible** if it should appear as a filter
     - Select the appropriate **Filter Type**
7. Save the configuration

**Screenshot: Filter Configuration UI**

 

![CRM Filter 1](https://nexusengage.com/hs-fs/hubfs/CRM%20Filter%201.png?width=571&height=293&name=CRM%20Filter%201.png)

 

---

#### **Add From CRM – Custom Results Display**

Admins can configure which CRM fields appear in the search results grid when users perform an Add From CRM action.

### Supported Behavior

- Display fields are read-only
- Order of columns follows admin configuration
- Display fields do not affect filtering logic
- Visibility can be decided if that field must appear in columns

Screenshot:

 

![CRM Filter 2](https://nexusengage.com/hs-fs/hubfs/CRM%20Filter%202.png?width=578&height=289&name=CRM%20Filter%202.png)

---

#### **Custom Filter Fields – Behavior & Validation**

Administrators can control how CRM records appear in the Add From CRM search modal.

### Configuration

- Managed from the **Table** tab in CRM Request Configuration
- Fields are shown as columns only when **Visible = ON**
- Column order follows the configured **Order** value
- Filters are applied using **AND logic**
- Multiple filters can be applied simultaneously
- Search triggers only after a minimum of **3 characters**
- Clearing filters resets results

### Results Display Behavior

- Read-only grid
- Entity-specific layouts
- Column headers match configured **Field Name**
- Order updates immediately after saving

---

#### **CRITICAL WARNING – CRM FIELD TYPE MATCHING (READ CAREFULLY)**

> Salesforce CRM – Mandatory Validation

> **When integrating with Salesforce CRM:**
> 
> - The filter type configured in **Add From CRM** **must exactly match** the underlying Salesforce field’s data type.
> - If a filter is configured with a mismatched type, the system will throw an error and **CRM search results will fail to load**.
> - This validation is **strictly enforced for Salesforce integrations**.

### Microsoft Dynamics CRM – Informational Only

> **For Microsoft Dynamics CRM:**
> 
> - The Add From CRM search continues to function even if filter types do not strictly match the Dynamics field type.
> - No runtime error is thrown due to filter type mismatch.
> - However, it is still recommended to align filter types correctly for consistency and best results.

---

### Supported Filter Type ↔ CRM Field Type Mapping

Administrators must ensure that filter types are configured according to the CRM field’s data category, especially for Salesforce.

 

 

 

| Filter Type   | Supported CRM Field Type   |
| --- | --- |
| **ID** | ID fields |
| **ID – Multi Select** | ID fields |
| **Date** | Date fields |
| **Number** | Number fields |
| **Number – Multi Select** | Number fields |
| **Dropdown** | Picklist fields |
| **Multi Select** | Picklist fields |
| **Multi Value Select** | Picklist fields |

 

 

 

⚠️ **Salesforce Only:**  
If a filter type outside of the supported mapping above is applied to a Salesforce field, the Add From CRM results will fail to load.

---

### Best Practice Recommendation

- Always verify the **CRM field data type** before configuring filters.
- Revalidate filter configuration after:
  
    - CRM schema changes
    - Field type updates
    - New custom fields added in Salesforce

---

#### **CRM Integration Details**

### **Salesforce**

- Supports standard and custom fields
- Honors Salesforce field data types
- Picklist filters rely on Salesforce picklist values
- Field type mismatches result in runtime errors

---

### **Microsoft Dynamics**

- Supports mapped Dynamics entity fields
- Data type enforcement is strict
- Option Sets must be configured as matching filter types
- Misconfigured filters prevent search execution

---

#### **Important Considerations & Limitations**

- Filters are admin-configured only
- No automatic data type conversion is performed
- CRM schema changes may require reconfiguration
- Feature availability depends on CRM permissions
- Filters and display fields are entity-specific
- Results display fields cannot be used as filters unless explicitly configured

---

#### **FAQs**

**Q: Can end users modify filters?**  
No. Filters are defined by administrators/Bes Admins only.

**Q: What happens if a CRM field type changes?**  
The filter must be updated manually to match the new type.

**Q: Are filters shared across CRM objects?**  
No. Each entity (Account, Contact, Opportunity) is configured separately.

- [Engagement Hub](https://nexusengage.com/help/engagement-hub#main-content)
  
  
  
  
  
    - [Release Notes](https://nexusengage.com/help/engagement-hub#release-notes)
    - [Dashboard and Calendar](https://nexusengage.com/help/engagement-hub#dashboard-and-calendar)
    - [Visit Requests and Form](https://nexusengage.com/help/engagement-hub#visit-requests-and-form)
    - [Visit Scheduling and Management](https://nexusengage.com/help/engagement-hub#visit-scheduling-and-management)
    - [Site and Room Administration](https://nexusengage.com/help/engagement-hub#site-and-room-administration)
    - [User Management and Profiles](https://nexusengage.com/help/engagement-hub#user-management-and-profiles)
    - [System Configurations](https://nexusengage.com/help/engagement-hub#system-configurations)
    - [API](https://nexusengage.com/help/engagement-hub#api)
    - [Domain](https://nexusengage.com/help/engagement-hub#domain)
    - [Topics/Agenda](https://nexusengage.com/help/engagement-hub#topics-agenda)
    - [Global Settings](https://nexusengage.com/help/engagement-hub#global-settings)
    - [Visit Types](https://nexusengage.com/help/engagement-hub#visit-types)
    - [Admin](https://nexusengage.com/help/engagement-hub#admin)
    - [Communication](https://nexusengage.com/help/engagement-hub#communication)
    - [Visit Management](https://nexusengage.com/help/engagement-hub#visit-management)
    - [Artificial Intelligence (AI)](https://nexusengage.com/help/engagement-hub#artificial-intelligence-ai)
    - [Availability](https://nexusengage.com/help/engagement-hub#availability)
    - [Visit List](https://nexusengage.com/help/engagement-hub#visit-list)
    - [Export](https://nexusengage.com/help/engagement-hub#export)
    - [Requestor](https://nexusengage.com/help/engagement-hub#requestor)
    - [FAQ](https://nexusengage.com/help/engagement-hub#faq)
    - [Login Access](https://nexusengage.com/help/engagement-hub#login-access)
    - [Coordinator](https://nexusengage.com/help/engagement-hub#coordinator)
    - [Visit Status](https://nexusengage.com/help/engagement-hub#visit-status)
    - [Individual Time Block](https://nexusengage.com/help/engagement-hub#individual-time-block)
    - [Navigation](https://nexusengage.com/help/engagement-hub#navigation)
    - [Itinerary](https://nexusengage.com/help/engagement-hub#itinerary)
    - [Invitation](https://nexusengage.com/help/engagement-hub#invitation)
    - [Speakers](https://nexusengage.com/help/engagement-hub#speakers)
    - [Off-Site](https://nexusengage.com/help/engagement-hub#off-site)
    - [Survey](https://nexusengage.com/help/engagement-hub#survey)
    - [Attendee](https://nexusengage.com/help/engagement-hub#attendee)
- [Sales Enablement Hub](https://nexusengage.com/help/sales-enablement-hub#main-content)
  
  
  
  
  
    - [Dynamics Application](https://nexusengage.com/help/sales-enablement-hub#dynamics-application)
    - [Salesforce Application](https://nexusengage.com/help/sales-enablement-hub#salesforce-application)
    - [Release Notes](https://nexusengage.com/help/sales-enablement-hub#release-notes)
- [Experience Hub](https://nexusengage.com/help/experience-hub#main-content)
  
  
  
  
  
    - [Customer Portal](https://nexusengage.com/help/experience-hub#customer-portal)
    - [Onsite Channels](https://nexusengage.com/help/experience-hub#onsite-channels)
    - [Program Site](https://nexusengage.com/help/experience-hub#program-site)
    - [Content Management](https://nexusengage.com/help/experience-hub#content-management)
    - [Analytics](https://nexusengage.com/help/experience-hub#analytics)
    - [Nexus Experience Hub Single Sign On](https://nexusengage.com/help/experience-hub#nexus-experience-hub-single-sign-on)
    - [Content Chapters](https://nexusengage.com/help/experience-hub#content-chapters)
    - [Door Monitor](https://nexusengage.com/help/experience-hub#door-monitor)
    - [Media](https://nexusengage.com/help/experience-hub#media)
    - [Home Screen](https://nexusengage.com/help/experience-hub#home-screen)

[![Nexus-Logo](https://nexusengage.com/hs-fs/hubfs/Nexus-Logo.jpg?width=143&height=50&name=Nexus-Logo.jpg "Nexus-Logo")](http://www.signet.tv)

Nexus Help Center

 Contact Nexus Support: [support@nexuscenter.io](mailto:support@nexuscenter.io) 

Copyright © 2025, Nexus

```json
{
  "@context" : "https://schema.org",
  "@id" : "https://nexusengage.com/#organization",
  "@type" : "Organization",
  "description" : "AI-powered customer engagement platform for enterprise teams.",
  "knowsAbout" : [ "Customer Engagement", "Briefing Programs", "Customer Experience", "Sales Enablement", "Executive Briefings", "Customer Advocacy" ],
  "logo" : {
    "@type" : "ImageObject",
    "height" : 32,
    "url" : "https://nexusengage.com/hubfs/raw_assets/public/nexus-theme/images/theme/nexus-logo.svg",
    "width" : 160
  },
  "name" : "Nexus",
  "sameAs" : [ "https://www.linkedin.com/company/nexus-hub/" ],
  "url" : "https://nexusengage.com"
}
```

```json
{
  "@context" : "https://schema.org",
  "@id" : "https://nexusengage.com/#website",
  "@type" : "WebSite",
  "inLanguage" : "en",
  "name" : "Nexus",
  "publisher" : {
    "@id" : "https://nexusengage.com/#organization"
  },
  "url" : "https://nexusengage.com"
}
```