New Theme Structure

Hi, I hope you’re doing well!

I wanted to reach out to get a better understanding of how the new theme structure works in Shopify. Specifically, could you please explain the concepts of Groups and Pairs, and how blocks within blocks function?

If there’s any official documentation, video playlist, or resource you could share that walks through these new theme structures, I’d really appreciate it.

Also, I’m not sure if you’re able to assist with code-related queries — but if you can:

Could you please explain how content_for works in this context? How exactly are blocks rendered?

As an example:

If I wanted to add a custom link for each collection in a collection list, how would I go about targeting a specific collection? I’ve noticed that there aren’t distinct blocks for each collection, so I’m unsure where the flexibility lies.

Thanks so much for your time and assistance!

Here is the break down of it:
Theme Structure – Groups & Pairs:
Shopify’s new theme architecture with “groups” and “pairs” is part of the ongoing push for more flexible and modular customization.

  • Groups are used to organize related settings or blocks under one visual section in the theme editor.

  • Pairs represent label-value pairs or two interdependent inputs (like an image and caption). They make theme settings more structured and intuitive.

Blocks within Blocks (Nested Blocks):
Shopify now allows nesting of blocks inside other blocks, useful for components like tab sections or product cards. This helps developers define reusable and dynamic UI layouts without duplicating logic.

1 Like