Ui Extensions: `<TextBlock/>` vs `<s-paragraph/>` regressions

Extensions
,
1

Ui Extensions: <TextBlock/> vs <s-paragraph/> regressions

While working on our React to Preact migration, we’ve hit roadblocks for this component.

React: TextBlock
Preact: s-paragraph

Would it be possible to address the following regressions?:

  • emphasis - No longer available, we need bold and italics, can we restore this regression?

  • size - The only available size now is small through the new type prop. The original size prop is no longer available, can we restore all available sizes lost in this regression?

  • inlineAlignment - No longer available, and no equivalent prop in the Preact component. Strangely, the documentation for the Paragraph component suggests the following: “Paragraphs support alignment options and can wrap inline components to create rich, formatted content blocks.”, but there is no alignment prop in the Preact component. Can we restore this regression?

    image
    image832×402 48.2 KB

Checks:

  • Docs, confirm regression.

  • IDE, confirms regression.

  • Trying to implement, confirms regression.

Context:

  • @shopify/ui-extensions-react: 2025.7.3

  • vs

  • @shopify/ui-extensions: 2026.4.0

Thank you very much!

2

Hey @muchisx :waving_hand:

We have more detailed component migration docs now that should be able to help with this - see here for TextBlock.

Note that some features were intentionally removed to help improve the Checkout UX consistency.

3

Hi @Kenza_Iraki , thanks for the feedback, been checking these new docs since they came out, they are very helpful, thanks to the team!

I understand why removing the size prop.

For this component specifically though, it does say in the docs “Paragraphs support alignment options”. Wouldn’t it be considered a point of inconsistency here to not provide this prop atleast?

The docs say there’s a textAlign prop but it is not present:

image
image501×246 9.93 KB

4

Hey @muchisx

That’s a case of the docs having been updated too early, apologies.

It’s a prop that was initially removed from paragraph that we’re about to bring back.

I’ll let you know when this has been done.

5

Hey @muchisx textAlign has made its return to s-paragraph.

Docs: Paragraph
Package: https://www.npmjs.com/package/@shopify/ui-extensions/v/2026.4.3

Thanks again for reporting!

6

Thanks @Robin-Shopify @Kenza_Iraki !

Kind of related to thread, is there any changelog we can follow for these kinds of changes? It seems it has landed to 2026-04, so I assume we can expect future changes to already released API versions of UI Extensions.