Skip to content

How to Show WooCommerce Products in Metro Layout in WordPress?

Key Takeaways

  • Nexter Blocks Product Listing block shows WooCommerce products in a creative Metro layout on a WordPress website.
  • Metro layout uses a unique tile-based design, and the Layout section lets the user select Metro after choosing the listing type and style.
  • Columns Manager tab manages layout columns and style, and it also lets the user create a custom metro layout for products.
Table of Contents

In a normal grid every product looks equally important. On a shop front that is rarely true, and the product you most want to sell deserves more room.

Metro lays products out as tiles of different sizes, so the first few are larger.

Before You Start

  • Edition: Pro — the Product Listing block needs Nexter Blocks Pro.
  • Block to enable: Product Listing, switched on under Nexter > Blocks in your WordPress dashboard.
  • WooCommerce active, with published products. The block reads your real catalogue, so an empty store renders an empty listing.
  • Enough products to fill the pattern, or the layout shows gaps.

Steps

  1. Select your Product Listing block.
The Product Listing block
  1. Set the layout to metro.
Choosing the metro layout
  1. Choose a metro style, which decides which tiles are large.
  1. Set the metro columns per device.
  1. Order your products so the right one lands in the large tile, then publish.

How It Behaves

Metro uses its own markup and carries its settings in a dedicated attribute.

  • Measured on a published page: the wrapper rendered data-layout="metro" with the class tpgb-metro, and the tile settings carried in data-metroAttr with separate desktop, tablet and mobile values.
  • Tile size is positional. The block does not know which product matters most, so the largest tile is simply the first in the query. Control it with the ordering, or by listing specific products — see show a product by ID.
  • Every card carries its own data. Measured on a published page, each product renders as an article whose classes include its category (product_cat-...), its tags (product_tag-...), its stock state (instock or outofstock) and whether it is on sale.
  • Metro suits a shop front, not a full catalogue, because the pattern repeats awkwardly over many rows.
  • Measured with Nexter Blocks Pro deactivated: the block renders nothing at all — no wrapper, no products, no prices. This is a Pro-only block.

Limitations

  • Pro only — measured with Nexter Blocks Pro deactivated, nothing renders.
  • It needs enough products to complete the pattern, or gaps appear.
  • Different tile sizes crop images differently, so a product image that looks right in a small tile may be badly cropped in a large one.
  • Metro rarely survives a phone screen. At one column the size differences vanish.
  • Reordering your products changes which one is featured, which is easy to do by accident when the ordering is by date.

Troubleshooting

There are gaps in the layout

Not enough products to complete the pattern. Increase the product count.

The wrong product is in the big tile

The large tile is the first product in the query. Change the ordering, or list specific product IDs.

My product images are cropped badly

Tiles of different shapes crop differently. Use images with the subject near the centre.

It looks like a plain grid

Check Nexter Blocks Pro is active. Measured with Pro off, the block renders nothing.

Related Docs

Share your Thoughts

Still in Doubt? Let’s Assist You

Have Feedback or Questions?

Join our WordPress Community on Facebook!

Related Frequently Asked Questions

What do I need before showing WooCommerce products in a metro layout in WordPress?

Nexter Blocks Pro is the key requirement, because the Product Listing block is Pro-only. The page also says WooCommerce must be active with published products, and the block reads your real catalogue, so an empty store gives you an empty listing. One more practical constraint matters: you need enough products to complete the metro pattern, or the layout will show gaps instead of a clean tile arrangement.

Why does the metro layout show gaps when I don’t have many products?

Metro uses a repeating tile pattern, so it needs enough products to fill that pattern cleanly. When the product count is too low, the layout leaves visible gaps instead of stretching to fit. In practice, this is why metro works better for a focused shop front than for a sparse catalogue. Adding more products is the fix, not changing the block’s visual style.

How do I make sure the right product appears in the big tile?

Tile size is positional, so the first product in the query becomes the large tile. That means ordering matters more than product importance inside the block itself. If you want a specific item featured, change the ordering or list specific products by ID using show a product by ID. This is the main gotcha with metro: it does not automatically pick your best seller.

Why are my WooCommerce product images cropped badly in metro layout?

Different tile shapes crop images differently, so an image that looks fine in one tile can look awkward in another. The safest approach is to keep the subject near the centre of each image, because metro tiles vary in size and shape. That matters more here than in a normal grid, since metro intentionally gives some products much larger tiles.

Does metro layout work well on mobile devices?

Metro loses most of its visual point on a phone screen because at one column the size differences vanish. The page calls out that metro rarely survives a phone screen for that reason. On smaller devices, it behaves much closer to a plain list of equally sized items, so it is better suited to wider shop-front layouts than mobile-first merchandising.

Is there another way to show WooCommerce products if I don’t want metro layout?

Nexter Blocks also offers Show products in grid layout and Show products in a custom metro layout. Metro is best when you want the first few products to feel more important than the rest, while grid keeps every product visually equal. If you need a simpler catalogue look or more control over spacing, those related layouts are the natural fallback.

Last reviewed: September 27, 2026

Related Docs