# ValueListItem

Location: [gRPC API](https://developer.m-files.com/APIs/gRPC-API/index.md) > [Reference](https://developer.m-files.com/APIs/gRPC-API/Reference/index.md) > [Messages](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/index.md)

HTML version: https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ValueListItem/

An item of a value list, or an object seen as an item of its object type (for example in lookup
results).

- **Full name:** `MFiles.ValueListItem`
- **Proto file:** [`mfiles/structs.proto`](https://developer.m-files.com/APIs/gRPC-API/downloads/proto/mfiles/structs.proto)

<a id="fields"></a>

## Fields

| Field | Type | Number | Description |
|---|---|---|---|
| <a id="f-item_info"></a>`item_info` | [`ItemInfo`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ItemInfo/index.md) | 1 | The item's identity and name: `obj_id.type` is the value list ID, `obj_id.item_id.internal_id` the item ID (unique within the list only), plus `name`, `guid`, `external_id` and flags. `options.is_deleted` marks a deleted item. |
| <a id="f-has_parent"></a>`has_parent` | `bool` | 2 | True if the item has a parent item in the same (hierarchical) list. |
| <a id="f-has_owner"></a>`has_owner` | `bool` | 3 | True if the item belongs to an item of the owner list (`ValueList.owner_object_type`). |
| <a id="f-parent_id"></a>`parent_id` | `int32` | 4 | With `has_parent`, the item ID of the parent item; otherwise ignored. |
| <a id="f-owner_id"></a>`owner_id` | `int32` | 5 | With `has_owner`, the item ID of the owner item in the owner list. |
| <a id="f-owner_name"></a>`owner_name` | `string` | 6 | The name of the owner item. |
| <a id="f-automatic_permissions"></a>`automatic_permissions` | [`AutomaticPermissions`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.AutomaticPermissions/index.md) | 7 | If set, specifies the automatic permissions for an object for which the user selects this item. |
| <a id="f-icon"></a>`icon` | [`Bytes`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.Bytes/index.md) | 8 | If set, contains the icon of this item in .ICO format. |

<a id="used-by-methods"></a>

## Used by methods

- [IRPCDataExport.GetExportedValueListItems](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCDataExport/GetExportedValueListItems/index.md): Gets the items of a value list in batches ordered by item ID.
- [IRPCDataExport.GetExportedValueListItemsByID](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCDataExport/GetExportedValueListItemsByID/index.md): Gets the given items of a value list.
- [IRPCIndexingDataSource2.GetValueListItemsForIX](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCIndexingDataSource2/GetValueListItemsForIX/index.md): Gets the items of one value list for a search index: all items page by page, or the changes since a known version.
- [IRPCObjectTypesAdmin.AddObjectTypeItem](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectTypesAdmin/AddObjectTypeItem/index.md): Adds an item to a value list as an administrator.
- [IRPCObjectTypesAdmin.UpdateObjectTypeItem](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectTypesAdmin/UpdateObjectTypeItem/index.md): Updates an item of a value list (for example its name, parent or owner) as an administrator.
- [IRPCSearch.SearchReferencedValueListItems](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCSearch/SearchReferencedValueListItems/index.md): Gets value list items that are referenced by one or more documents (possibly limiting the set of documents with conditions) in ID order.
- [IRPCValueLists.AddValueListItemFromClient](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCValueLists/AddValueListItemFromClient/index.md): Adds a new item to a value list, as a user.
- [IRPCValueLists.CreateOrFindTraditionalFolder](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCValueLists/CreateOrFindTraditionalFolder/index.md): Creates a traditional folder, or returns an existing folder with the same name.
- [IRPCValueLists.GetValueListItemProposals](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCValueLists/GetValueListItemProposals/index.md): Gets the values that the calling user has most recently used for a lookup property.
- [IRPCValueLists.GetValueListItemsWithPermissions](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCValueLists/GetValueListItemsWithPermissions/index.md): Gets the items of one value list or object type, or only the changes since a known version.
- [IRPCValueLists.RenameValueListItemFromClient](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCValueLists/RenameValueListItemFromClient/index.md): Renames a traditional folder.
- [IRPCValueLists.SearchValueListItemsWithPermissions](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCValueLists/SearchValueListItemsWithPermissions/index.md): Searches the items of one value list or object type by item ID, name, owner, parent or deleted state.
- [IRPCValueLists.UpdateValueListItemFromClient](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCValueLists/UpdateValueListItemFromClient/index.md): Updates an item of a plain value list or a traditional folder, as a user.
- [IRPCViews.CreateSubFolder](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCViews/CreateSubFolder/index.md): Creates a traditional folder at a location inside a view, or returns an existing folder with the same name there.

<a id="used-by-messages"></a>

## Used by messages

- [`DocClass`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.DocClass/index.md): Struct for a document class in a vault.
- [`ObjectClass`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ObjectClass/index.md): A class: a kind of object within one object type, with the properties its objects have.
- [`ValueListItemData`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ValueListItemData/index.md): A value list item with, on request, its permissions.
- [`ValueListItemDecl`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ValueListItemDecl/index.md): Value list item structure.