Administrators and developers often need to customize the Search Layout for both standard and custom objects within their Salesforce orgs.ย
Customizing a Search Layout allows users to select the standard and custom fields that are displayed when records from that object appear in various places around Salesforce. Such as when returned in a search, displayed in a lookup dialog or on the recently viewed records list displayed on the tab home page.
What metadata type to select in the filter?
Search Layout is a part of Custom object
metadata type.
So Custom object must be added to your filter and retrieved in order to deploy changes to Search Layouts.
Where to find Search Layout in a Salesforce org?
To customize a Search Layout, locate the object in the Setup
menu within Salesforce and select the Search Layouts
item on that object (menu on the left hand side).
This is an example of a Search Layout on the Account object:
Following this example, we've made a customization on the Search Layout for Standard User
, and now the Search Layout
includes: Account Name
, Account Site
, Phone
, Account Owner Alias
and Billing Street
fields.
How do Search Layouts look in the comparison results?
Now, when the org (in which the change was made) is compared either to another org or to a Git branch (source control), Gearset will highlight that the Account
object has changed.
Deploying the Account
object will deploy the Search Layout changes.
Why do I see the same object twice in my comparison results?
It's an expected behaviour to find the Custom object
being present twice in the comparison results when looking at the All items
tab.
โ
You'd normally see your Custom object (in this example Account
):
- once as Different
, including the Search Layout
change(s) you made
- and once as No difference
.
โ
Is the Search Layout supported in precision deployments?
Currently, our precision deployments feature doesn't support incremental deployments of the Custom object
metadata type - that is if you wanted to only deploy the changes made to your Search Layout
on a specific custom/standard object, rather than having to include the entire Custom object to the deployment package.