---
schema_version: "1"
id: 1ebddea742731a18e926971f51ad96e20fd514efa3f21996afd1e6d28bdd0422
title: InStoreLocation
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/retail_api/sforce_api_objects_instore_location.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.retail_api.meta/retail_api/sforce_api_objects_instore_location.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: a248869ffa4ce6291edc1b709a43cf45fb276e223dd4930cf893f72326735bb5
description: Create locations within a retail store’s layout such as aisles, shelves, or backrooms. This object is available in API version 47.0 and later.
---
# InStoreLocation

Create locations within a retail store’s layout such as aisles, shelves, or backrooms. This object is available in API version 47.0 and later.

## Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

## Fields

### Category

- **Type**: picklist
- **Properties**: Create, Defaulted on create, Filter, Group, Nillable, Sort, Update
- **Description**: Category of similar in-store location types across a store group.
- **Possible values**:
    - Aisle
    - Backroom
    - Endcap

### Description

- **Type**: textarea
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: Description of the in-store location.

### InStoreLocationType

- **Type**: picklist
- **Properties**: Create, Defaulted on create, Filter, Group, Restricted picklist, Sort, Update
- **Description**: Type of in-store location. Most retail stores have similar layouts and have common in-store location types.
- **Possible values**:
    - Assets
    - Backroom
    - Bin
    - Other
    - Shelf

### LastReferencedDate

- **Type**: dateTime
- **Properties**: Filter, Nillable, Sort
- **Description**: The most recent date on which a user referenced this record.

### LastViewedDate

- **Type**: dateTime
- **Properties**: Filter, Nillable, Sort
- **Description**: The most recent date on which a user viewed this record.

### LocationId

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: ID of the GPS coordinates of the retail store.

### Name

- **Type**: string
- **Properties**: Create, Filter, Group, idLookup, Sort, Update
- **Description**: User-defined name of the in-store location.

### PlanogramId

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Planogram image associated with the in-store location.

### RetailStoreId

- **Type**: reference
- **Properties**: Create, Filter, Group, Sort
- **Description**: ID of the store associated with the location.

## Associated Objects

This object has the following associated objects. Unless noted, they’re available in the same API version as this object.

- **[InStoreLocationFeed](https://developer.salesforce.com/docs/atlas.en-us.retail_api.meta/retail_api/sforce_api_associated_objects_feed.htm "StandardObjectNameFeed is the model for all feed objects associated with standard objects. These objects represent the posts and feed-tracked changes of a standard object.")**: Feed is available for the object.
- **[InStoreLocationHistory](https://developer.salesforce.com/docs/atlas.en-us.retail_api.meta/retail_api/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.")**: History is available for the object.