`ActionBar` removed on mobile: `TitleBar` primary action now renders as an icon button
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on April 15, 2026.
This Shopify update is categorized as Action Required, API, New, App Bridge.
What changed
Mobile primary action now renders as an icon in the title bar On mobile, the primary and secondary actions defined on your TitleBar are changing how they render: The primary action now displays as an icon-only button in the mobile header, rather than in a bottom bar with icon and text. Secondary actions now appear in the overflow menu, creating a more consistent mobile interface. If you don't pass an icon property with your primary action, it defaults to a + (plus) icon.
Who is affected
All embedded apps that define a primary action or secondary actions on their TitleBar. When the changes go into effect Changes go live to all affected apps on April 15th, 2026.
What action may be needed
If the default + icon fits your use case, no changes are needed. Otherwise: Pass an explicit icon with the primary action on your TitleBar to ensure the most contextually appropriate icon displays on mobile.
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →