How to Use Concealed Text Fields in Business Central AL

Business Central offers tools to secure sensitive data, including Secret Text and Isolated Storage. The recent update, Business Central 27.1, introduces the Concealed Text Field, enabling masked input for sensitive entries to enhance privacy. This feature is easily activated in the Feature Management page and applies to various field types.

Marcel Chabot

November 14, 2025

1–2 minutes

AL, Business Central, development, dynamics-365, dynamics-365-business-central, microsoft-dynamics-365-business-central

There are several tools and technology in Business Central designed to help keeps data secure.

We have Secret Text and Isolated Storage:

Securing Sensitive Data in Business Central AL using SecretText

The challenge I have is that I still need to enter that text and it would be great to have a masked input to prevent screen captures and shoulder surfers from seeing my sensitive data.

Business Central 27.1 introduces the Concealed Text Field to solve this problem!

Step one, after updating to Business Central 27.1, is to ensure that it is activated in the Feature Management page.

In your Business Central Code, you can now set a fields Mask Type to Concealed.

field(APIKey; UserAPIKey)
{
    ApplicationArea = All;
    Caption = 'API Key';
    ToolTip = 'Enter the API key for the Copilot service.';
    MaskType = Concealed;
    trigger OnValidate()
    begin
        IsolatedStorageWrapper.SetSecretKey(UserAPIKey);
    end;
}

When you enter text into that field, it will display the masking we are all accustom too.