# InstructionalText Property
> Version: _Available or changed with runtime version 1.0._
Sets the string used for instructions in the UI.
## Applies to
 Page
 Request Page
 Page Field
 Page Group
## Parameters
Locked
Type: ../methods-auto/boolean/boolean-data-type
If true the InstructionalText is locked and should not be translated.
Comment
Type: ../methods-auto/text/text-data-type
Descriptive text for the InstructionalText, for example, with regards to translation.
MaxLength
Type: ../methods-auto/integer/integer-data-type
Sets the maximum length of the specific InstructionalText.
## Remarks
The default is an empty string, which means there are no instructions. According to the user assistance model for Business Central, apps are expected to apply instructional text, also called placeholder text, to setup guides and similar pages.
> NOTE
> The InstructionalText property can be applied to Text, BigText, Guid, and Code data type fields.
The following example illustrates how you can apply placeholder text in an app:
```al
InstructionalText = 'Add an entity from your list of contacts. The entity can be a person or a company.';
```
Or, with the parameters:
```al
InstructionalText = 'Add an entity from your list of contacts. The entity can be a person or a company.', Locked = true, Comment = 'Keep like this, do not translate.', MaxLength = 100;
```
The InstructionalText property on a page field should provide an example value or a short summary of the field's purpose to guide the user towards entering the expected value.
## Related information
Configuring the Help Experience<../../deployment/configure-help>
../devenv-page-object

Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/properties/devenv-instructionaltext-property, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact. https://jonas-paprotka.de/docs/dev-itpro/developer/properties/devenv-instructionaltext-property/
