# PropertyValueWithMetadata

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

Property value metadata namespace.

- **Full name:** `MFiles.PropertyValueWithMetadata`
- **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_def"></a>`property_def` | `int32` | 1 | Property definition ID. |
| <a id="f-value"></a>`value` | [`TypedValueWithMetadata`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.TypedValueWithMetadata/index.md) | 2 | The value of the property. |

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

## Used by methods

- [IRPCObjectOperations.AddObjectWithFilesWithPropertyMetadata](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/AddObjectWithFilesWithPropertyMetadata/index.md): Creates a new object with files, storing metadata about each property value (who or what set it, why, and with what confidence).
- [IRPCObjectOperations.CreateNewObjectWithPropertyMetadata](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/CreateNewObjectWithPropertyMetadata/index.md): Creates a new object without files, storing metadata about each property value.
- [IRPCObjectOperations.GetObjectInfoAndPropertiesWithMetadata](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/GetObjectInfoAndPropertiesWithMetadata/index.md): Like GetObjectInfoAndProperties, but each property value also carries its value metadata.
- [IRPCObjectOperations.GetPropertyValueWithMetadata](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/GetPropertyValueWithMetadata/index.md): Gets a property value and its metadata.
- [IRPCObjectOperations.SetPropertiesWithMetadata](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/SetPropertiesWithMetadata/index.md): Adds, replaces or removes property values of an object, also storing metadata about each value.
- [IRPCObjectOperations.SetPropertiesWithMetadataAttributedTo](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/SetPropertiesWithMetadataAttributedTo/index.md): Sets property values with metadata and records the change as made by a built-in agent user.
- [IRPCObjectOperations.SetPropertyValueMetadata](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/SetPropertyValueMetadata/index.md): Changes the metadata of property values without changing the values.

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

## Used in fields

- [`ObjectVersionExWPWithMetadata.properties`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ObjectVersionExWPWithMetadata/index.md#f-properties): Property values, or an empty array.
- [`GetPropertyValueWithMetadataResponse.prop_val_with_metadata`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/GetPropertyValueWithMetadata/index.md#response): Receives the property value with metadata.
- [`GetObjectInfoAndPropertiesWithMetadataResponse.property_array`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/GetObjectInfoAndPropertiesWithMetadata/index.md#response): Receives the object version properties (when found and visible).
- [`SetPropertiesWithMetadataRequest.properties`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/SetPropertiesWithMetadata/index.md#request): The properties to add/replace.
- [`SetPropertiesWithMetadataResponse.property_array`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/SetPropertiesWithMetadata/index.md#response): Receives the object version properties (when found and visible).
- [`SetPropertyValueMetadataRequest.property`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/SetPropertyValueMetadata/index.md#request): The properties to add/replace.
- [`SetPropertyValueMetadataResponse.property_array`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/SetPropertyValueMetadata/index.md#response): Receives the object version properties (when found and visible).
- [`CreateNewObjectWithPropertyMetadataRequest.properties_with_metadata`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/CreateNewObjectWithPropertyMetadata/index.md#request): Property values of the new object, each with `value_metadata` (required, with a numeric `confidence`).
- [`AddObjectWithFilesWithPropertyMetadataRequest.properties_with_metadata`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/AddObjectWithFilesWithPropertyMetadata/index.md#request): Property values of the new object, each with `value_metadata` (required, with a numeric `confidence`).
- [`SetPropertiesWithMetadataAttributedToRequest.property_values`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/SetPropertiesWithMetadataAttributedTo/index.md#request): The property values with metadata to set.