# ElectronicSignatureSettings

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

Electronic signature settings.

- **Full name:** `MFiles.ElectronicSignatureSettings`
- **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-is_required"></a>`is_required` | `bool` | 1 | True if this transition requires an electronic signature. |
| <a id="f-prompt_mode"></a>`prompt_mode` | [`ElectronicSignaturePromptMode`](https://developer.m-files.com/APIs/gRPC-API/Reference/Enums/MFiles.ElectronicSignaturePromptMode/index.md) | 2 | Option 1: static reason/meaning. Values: `ELECTRONIC_SIGNATURE_PROMPT_MODE_FIXED` (0), `ELECTRONIC_SIGNATURE_PROMPT_MODE_SELECTABLE` (1). |
| <a id="f-fixed_prompt_details"></a>`fixed_prompt_details` | [`ElectronicSignaturePromptInfo`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ElectronicSignaturePromptInfo/index.md) | 3 | Option 2: Pre-defined reason |
| <a id="f-selectable_prompt_details"></a>`selectable_prompt_details` | repeated [`ElectronicSignaturePromptInfo`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ElectronicSignaturePromptInfo/index.md) | 4 | Option 3: Metadata-based reason/meaning. |
| <a id="f-user_selectable_reason_meaning_items_property_def"></a>`user_selectable_reason_meaning_items_property_def` | `int32` | 11 | A property definition that represents items in value list. Used if the prompt mode is eesrmpmPromptModeMetadataBasedUserSelectable. |
| <a id="f-user_selectable_reason_property_def"></a>`user_selectable_reason_property_def` | `int32` | 12 | A property definition that indicates the reason property. PROPERTYDEF_UNINITIALIZED if no reason is specified. Used if the prompt mode is eesrmpmPromptModeMetadataBasedUserSelectable. |
| <a id="f-user_selectable_meaning_property_def"></a>`user_selectable_meaning_property_def` | `int32` | 13 | A property definition that indicates the meaning property. PROPERTYDEF_UNINITIALIZED if no meaning is specified. Used if the prompt mode is eesrmpmPromptModeMetadataBasedUserSelectable. |
| <a id="f-add_metadata_reference_to_reason_meaning_item"></a>`add_metadata_reference_to_reason_meaning_item` | `bool` | 14 | Common prompt details. |
| <a id="f-prompt_free_form_text"></a>`prompt_free_form_text` | `bool` | 5 | True if a free-form text is prompted with the signature. |
| <a id="f-free_form_text_property_def"></a>`free_form_text_property_def` | `int32` | 6 | Signature details. boolean bFillReasonPropertyText;  //!< Optional? boolean bFillMeaningPropertyText;  //!< Optional? |
| <a id="f-manifestation_additional_info"></a>`manifestation_additional_info` | `string` | 7 | Additional information for the manifestation text for the signature. This is not shown to the user when signing. |
| <a id="f-create_separate_signature_object"></a>`create_separate_signature_object` | `bool` | 8 | True if the electronic signature shall be stored as a separate signature object. False to store as an embedded signature in a multi-line text property. |
| <a id="f-manifestation_property_def"></a>`manifestation_property_def` | `int32` | 9 | Property definition to be used for storing the signature manifestation on the object. Ignored if bCreateSeparateSignatureObject is true. |
| <a id="f-signature_identifier"></a>`signature_identifier` | `string` | 10 | Signature identifier. Required if bCreateSeparateSignatureObject is true. |

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

## Used by methods

- [IRPCObjectOperations.GetStateTransitionSignatureSettings](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/GetStateTransitionSignatureSettings/index.md): Gets the signature settings for a state transition.

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

## Used in fields

- [`AssignmentClassInfo.signature_settings_for_task_completion`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.AssignmentClassInfo/index.md#f-signature_settings_for_task_completion): Approval assignment features.
- [`AssignmentClassInfo.signature_settings_for_approval`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.AssignmentClassInfo/index.md#f-signature_settings_for_approval): The electronic signature settings for signature that is required for completing the assignment.
- [`AssignmentClassInfo.signature_settings_for_rejetion`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.AssignmentClassInfo/index.md#f-signature_settings_for_rejetion): The electronic signature settings for signature that is required for completing the assignment.
- [`DocClass.signature_settings_for_new_objects`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.DocClass/index.md#f-signature_settings_for_new_objects): The electronic signature settings for creating an electronic signature for new objects. Reserved for future improvements.
- [`ElectronicSignatureRequest.settings`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ElectronicSignatureRequest/index.md#f-settings): The electronic signature settings.
- [`ObjectClassDecl.signature_settings_for_new_objects`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ObjectClassDecl/index.md#f-signature_settings_for_new_objects): The electronic signature settings for creating an electronic signature for new objects. Reserved for future improvements.
- [`StateTransition.signature_settings`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.StateTransition/index.md#f-signature_settings): Signature settings for this state transition.
- [`GetStateTransitionSignatureSettingsResponse.settings`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCObjectOperations/GetStateTransitionSignatureSettings/index.md#response): Receives the signature settings.