# PropertyValueSuggestion

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.PropertyValueSuggestion/

The definition of an automatic value.

- **Full name:** `MFiles.PropertyValueSuggestion`
- **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-property_definition_id"></a>`property_definition_id` | `int32` | 1 | The property definition ID. |
| <a id="f-value"></a>`value` | [`TypedValue`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.TypedValue/index.md) | 2 | The typed value. |
| <a id="f-display_value"></a>`display_value` | `string` | 3 | Display value for the suggestion. Can be empty. |
| <a id="f-confidence"></a>`confidence` | `float` | 4 | The projected quality of the suggestion. |
| <a id="f-is_fact"></a>`is_fact` | `bool` | 5 | True if the suggestion is a fact (i.e. known to be valid for sure). |
| <a id="f-is_new_value_list_item"></a>`is_new_value_list_item` | `bool` | 6 | True if the suggestion depicts a new value for value lists. |
| <a id="f-new_value_list_item_property_suggestions"></a>`new_value_list_item_property_suggestions` | repeated [`PropertyValueSuggestion`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.PropertyValueSuggestion/index.md) | 7 | Suggestions that should be used when new object is created with this suggestion. |
| <a id="f-reason"></a>`reason` | `string` | 8 | Rationale explaining why the suggestion is being made. Can be empty. |
| <a id="f-suggested_name"></a>`suggested_name` | `string` | 9 | Display name of a not-yet-created property (discovery-origin only). Empty otherwise. |
| <a id="f-suggested_data_type"></a>`suggested_data_type` | `int32` | 10 | MFDataType of the suggested new property (discovery-origin only). Zero otherwise. |
| <a id="f-instruction"></a>`instruction` | `string` | 11 | LLM-authored extraction instruction for a discovery-origin property. Empty otherwise. |

<a id="used-in-fields"></a>

## Used in fields

- [`AutomaticMetadataResult.property_value_suggestions`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.AutomaticMetadataResult/index.md#f-property_value_suggestions): Property value suggestions.
- [`PropertyValueSuggestion.new_value_list_item_property_suggestions`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.PropertyValueSuggestion/index.md#f-new_value_list_item_property_suggestions): Suggestions that should be used when new object is created with this suggestion.