The Enable Search by Prefix feature modifies how CloudExtend’s global search communicates with NetSuite, improving search accuracy and performance for organizations with large data sets.
By default, CloudExtend performs a global search using the exact search term entered by the user (for example, searching for "3M").
When Search by Prefix is enabled, a record-type prefix (like cus:) is automatically appended to the search term, helping NetSuite narrow results by record type and improve speed.
Example:
Setting | Search Term Sent to NetSuite |
Disabled |
|
Enabled |
|
⚠️ Important
If your organization has renamed standard NetSuite records, you must map your custom record names to their standard NetSuite equivalents for this feature to work correctly.
Otherwise, searches may fail or return incomplete results.
Example:
Standard NetSuite record name:
CustomerYour custom record name:
AccountIf unmapped, the prefix
cus:3Mwon’t work — onlyacc:3Mwill.Mapping your record names resolves this issue.
See Further Customizing to Support Non-Default Record Names for details.
Who should enable search by prefix?
The feature should be enabled by customers who meet the following criteria:
Enable Search by Prefix if your organization:
Has a large number of records that match common search terms, leading to timeouts or slow searches.
Experiences too much data returned during Outlook auto-search or auto-fetch operations.
Tip: Combine this feature with Auto-Fetch or Auto-Search in ExtendSync for even faster record suggestions and associations.
➡️ Configure Auto-fetch or Auto-Search to attach emails quickly
How do I enable search by prefix?
Your NetSuite Administrator can enable the feature by following these steps:
In NetSuite, go to Customization → Scripting → Script Deployments.
Set filters to:
Type: RESTlet
API Version: 2.0
Locate the script deployment named customscript_celigo_global_search.
Open the Script Parameters tab.
Check the box for ENABLE SEARCH BY PREFIX.
Save your changes.
Further customizing to support non-default record names
If your company desires to use the Search by Prefix feature AND has changed the default NetSuite record names you must remap those using the format in the screenshot below {"netsuitename":"customname"}.
For example below will replace searches for customer records with acc:search term.
Disabling search by prefix
How to Disable Search by Prefix
If needed, you can turn this feature off at any time:
Follow steps 1–3 above to locate customscript_celigo_global_search.
Go to the Script Parameters tab.
Uncheck ENABLE SEARCH BY PREFIX.
Click Save.