# Remote Drop-down

The available configurations for this field are:

* Label
* Code
* Label
* Label Span
* Input Span
* Read Only
* Value Field
* Title
* Description
* Avatar
* Selected Item
* Schema Name
* Datasource
* Render in Cards
* Add new item

### Label

Label to be displayed alongside the field, if you don't define a label, the input will be displayed anyway

### Code

The path to the context. This path is used to set/get the value from the context

### Label and Input Span

These props are used to determine the space occupied by the label and the input

### Read Only

Disable the field

### Value Field

This field is used to get/set the selected value from the context. 

For instance, if you remote drop-down fetch a list of People (with `PersonId` and `Name`) and you want to save the `PersonId` you must configure it as the value field.

### Title, Description, and Avatar

These fields allow determining which props of the fetched data you want to display to the users

<figure><img src="/files/UQdBgbIbsD4QDFgPwvnq" alt=""><figcaption><p>Remote drop down display fields configuration</p></figcaption></figure>

This configuration results in this:

<figure><img src="/files/HHxmmE08KST0mcM3JGKI" alt=""><figcaption></figcaption></figure>

### Datasource

More details on [data sources section](/dev/configurations/components/datasources.md)

### Selected Item

In some cases, we need not just save the Id of the selected (`PersonId`) item but the entire item (`Person`) into the context. To save the entire object you must define the path (`SelectedPerson`) where this object will be saved.

### Schema Name

In paginated scenarios, we need to fetch the data plus the selected item, to get the selected item we use the GetById (`Country($Id)`) methods in Graphql, but that sometimes does not match the same name as the GetAll (`Countries($where)`) method used in the data source to fetch all items.

```graphql
query Countries($where: JSON) {
  Countries(where: $where) {
    Name
    Id
  }
}
```

For instance, in this query, the schema name to get the selected country is not `Countries` but `Country`

In this case, we need to set the Schema Name to `Country`

### Render In Cards

Allows to render items as Cards

<figure><img src="/files/QC2EFwyVZcJgWcBrtEUc" alt=""><figcaption></figcaption></figure>

### Add new Item

In some cases, you want to allow the users to add an item to the remote drop-down in case it does not exist

<figure><img src="/files/QG487r0vvs8JrNhAYyaK" alt=""><figcaption></figcaption></figure>

When you enable this option you will be asked which feature you want open when clicking the Add New Item button


---

# 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://codenull.gitbook.io/dev/configurations/components/forms/fields/remote-drop-down.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.