{"title":"InstructionalText Property","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/properties/devenv-instructionaltext-property/","by":"JOP-AL","license":"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.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/properties/devenv-instructionaltext-property","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Sets the string used for instructions in the UI.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":2,"title":"Applies to","slug":"applies-to","at":109,"chars":58},{"level":2,"title":"Parameters","slug":"parameters","at":167,"chars":392},{"level":2,"title":"Remarks","slug":"remarks","at":559,"chars":953},{"level":2,"title":"Related information","slug":"related-information","at":1512,"chars":109}],"text":"> Version: _Available or changed with runtime version 1.0._\nSets the string used for instructions in the UI.\n## Applies to\n Page\n Request Page\n Page Field\n Page Group\n## Parameters\nLocked\nType: ../methods-auto/boolean/boolean-data-type\nIf true the InstructionalText is locked and should not be translated.\nComment\nType: ../methods-auto/text/text-data-type\nDescriptive text for the InstructionalText, for example, with regards to translation.\nMaxLength\nType: ../methods-auto/integer/integer-data-type\nSets the maximum length of the specific InstructionalText.\n## Remarks\nThe 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.\n> NOTE\n> The InstructionalText property can be applied to Text, BigText, Guid, and Code data type fields.\nThe following example illustrates how you can apply placeholder text in an app:\n```al\nInstructionalText = 'Add an entity from your list of contacts. The entity can be a person or a company.';\n```\nOr, with the parameters:\n```al\nInstructionalText = '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;\n```\nThe 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.\n## Related information\nConfiguring the Help Experience<../../deployment/configure-help>\n../devenv-page-object"}