# Stores

Stores are off-chain [entities](https://github.com/decentraland/docs/blob/main/contributor/entities/README.md) that represent user-managed marketplace sites. They contain a description and a picture to show buyers, plus information about the store owner.

### Pointers <a href="#pointers" id="pointers"></a>

Store pointers are URNs in the `off-chain` namespace, with the following form:

```
urn:decentraland:off-chain:marketplace-stores:<owner-address>
```

The address segment is the Ethereum address of the store's owner. For example:

```
urn:decentraland:off-chain:marketplace-stores:0xa2a1dc503be6fdb7878f58f053ded40564e3b9b2
```

### Metadata Fields

| Field         | Value                                                                                                                                          |
| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`          | The [pointer](https://github.com/decentraland/docs/blob/main/contributor/pointers/README.md) that resolves (or used to resolve) to this store. |
| `description` | The display title for this store.                                                                                                              |
| `owner`       | The Ethereum address of the owner.                                                                                                             |
| `images`      | An array of `{ file, name }` objects referencing images (see below).                                                                           |
| `links`       | An array of `{ name, url }` objects with social media or website links (see below).                                                            |

#### Images

Stores have a picture to show buyers in the marketplace, each with a name identifying the role. The typical `images` array has a single element with the name `cover`, like this:

```json
[
  {
    "name": "cover",
    "file": "imgs/store-logo.png"
  }
]
```

#### Links

Owners can add external links to stores, such as social media profiles and external websites. Facebook and Discord URLs are commonly included. An example:

```json
[
  {
    "name": "facebook",
    "url": "https://www.facebook.com/mydclstore"
  },
  {
    "name": "website",
    "url": "https://mydclstore.com"
  }
]
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.decentraland.org/contributor/content/entity-types/stores.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.