---
schema_version: "1"
id: c3ab48e2acbb44a5748ddef226291b33f3fc3f7a09698f9e6ce3eeb8a7573aa5
title: ProfileSearchLayouts
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_profilesearchlayouts.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_profilesearchlayouts.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: ae93fb2d6013689672ba77fd583ac25f7f544e9af7175948204516b76bc9915a
description: Represents a user profile’s search results layouts for an object. ProfileSearchLayouts are similar to SearchLayouts. However, with profile-specific layouts, each user profile can have a different search results layout for an object.
---
# ProfileSearchLayouts

Represents a user profile’s search results layouts for an object. ProfileSearchLayouts are similar to SearchLayouts. However, with profile-specific layouts, each user profile can have a different search results layout for an object.

## File Suffix and Directory Location

Profile search layouts are defined as part of a standard or custom object. SearchLayout is the default search results layout used when no layout is specified for a user profile. For more information, see [CustomObject](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/customobject.htm "Represents a custom object that stores data unique to your org or an external object that maps to data stored outside your org.").

## Version

Profile search layouts for custom objects are available in API version 48.0 and later.

## Fields

| Field | Field Type | Description |
| --- | --- | --- |
| profileName | string\[\] | The name of the profile associated with a customized search results layout. The profile name can be a standard Salesforce profile or custom profile defined in your org. |
| fields | string\[\] | The list of fields displayed in search results for the object and for the users that have the profile Profile Name. The name field is required and is always displayed as the first column header, so it isn’t included in this list. All additional fields are included. The field name relative to the object name, for exampleMyCustomField\_\_c, is specified for each custom field. |

## Declarative Metadata Sample Definition

The following shows a sample definition of profile-specific search layouts in an object.

![Note](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/images/icon_note.png)

#### Note

To deploy a profile-specific search results layout, the profile must be defined in the destination org and if it's for a custom object, you must enable search for that custom object. If the profile-specific search results layout is for a custom object, the custom object's tab must exist in the destination org or must be included with the deployment.

<?xml version="1.0" encoding="UTF-8"?>
                <CustomObject xmlns="http://soap.sforce.com/2006/04/metadata">
                . . .
                <profileSearchLayouts\>
                <fields\>ACCOUNT.NAME</fields\>
                <fields\>ACCOUNT.SITE</fields\>
                <fields\>ACCOUNT.PHONE1</fields\>
                <fields\>CORE.USERS.ALIAS</fields\>
                <fields\>ACCOUNT.ADDRESS2\_CITY</fields\>
                <profileName\>System Administrator</profileName\>
                </profileSearchLayouts\>
                <profileSearchLayouts\>
                <fields\>ACCOUNT.NAME</fields\>
                <fields\>ACCOUNT.SITE</fields\>
                <profileName\>WDC Only User</profileName\>
                </profileSearchLayouts\>
                . . .
                </CustomObject\>

- [← Previous](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_picklist.htm "Picklist (Including Dependent Picklist)")
- [Next →](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_recordtype.htm "RecordType")

#### See Also

- [SearchLayouts](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_searchlayouts.htm "Represents the metadata associated with the search layouts for an object. You can customize which fields to display for users in search results, search filter fields, lookup dialogs, and recent record lists on tab home pages. You can access SearchLayouts only by accessing its encompassing CustomObject.")