Block Reason Field in Business Central (and How to Show it on the Item Card)
The Block Reason field in Business Central is an explanatory note linked to the Blocked status on Items. It helps teams document why something is blocked, improving communication and reducing confusion when Item are not visible in the Transaction Documents.
The Block Reason is already available on the underlying table.
If you don’t see it on the Item Card, you just need to surface it on the page—either with Design/Personalize or with a small AL page extension.
No-code: Design/Personalize (quickest)
Go to Settings ▸ Personalize (or Settings ▸ Design if you’re in a sandbox with page design enabled).
Click + Field / Field to open the available fields paneSearch for Block Reason. Drag & drop the field to the desired FastTab (usually near Blocked on the General tab). If prompted, unlock the field (it’s a normal text field; “unlocked” here just means it isn’t a locked system control on the page).
Save your personalization/design. (If you used Design, publish your changes.)
Low-code: AL Page Extension (best for managed rollouts)
pageextension 50101 ItemExtension extends "Item Card"
{
layout
{
addafter(Blocked)
{
field ("Block Reason"; Rec."Block Reason")
{
ApplicationArea = All;
Caption = 'Block Reason';
ToolTip = 'Reason for blocking the item';
}
}
}
}
Once you publish the extension. The Block Reason field will now be visible on the Item Card page.
You can directly enter an explanation in this field whenever you set the item as Blocked.
Summary
-
Block Reason explains why something is blocked and improves clarity across teams.
This was originally posted here.
*This post is locked for comments