01
Bring slower-changing product data together
Read product names, slugs, galleries, attributes, options, variants, category membership, reviews and SEO in a single shell query.
Magento 2.4.9
Headless Ready
Astro Storefront Required
INCLUDED IN AGENTICSUITE
Product Shell Bundle for Headless Magento
Give your storefront a cacheable foundation for product pages. Bundle stable product content so your delivery layer can handle price and stock freshness separately.
Part of the complete platform.
This capability is included in AgenticSuite. Get the Astro storefront and all headless and Luma-compatible modules listed on this website.
Explore AgenticSuite Discuss your Magento projectYour platform. Your control.Full source code and your business data.
Built to work togetherAstro storefront and comprehensive Magento modules.
Check your requirements with us - Names, galleries, attributes, options and SEO
- Cacheable product-page shell data
- Separate price and stock refresh strategy
Cache duration, price and stock freshness depend on the storefront integration.
BUILT AROUND THE WAY YOU WORK
Cache the content. Plan the live commerce checks.
Included in AgenticSuite. This is part of a headless Magento implementation; the storefront and deployment must be configured to use it.
02
Choose a deliberate freshness strategy
Pre-warm and cache the stable page content, then fetch price and stock separately where your implementation requires it. Verify checkout values and invalidation behaviour.
A CLEAR WORKFLOW
From setup to everyday use.
- 01
Explore AgenticSuite and the live storefronts to see how the parts fit together.
- 02
Discuss your current Magento setup, integrations and requirements with our team.
- 03
Configure and test this capability as part of the agreed storefront project.
Do I need to buy this capability separately?+
AgenticSuite includes the Astro storefront and all headless and Luma-compatible modules listed on this website. Discuss the complete platform and your implementation scope with us.
Can you migrate my current store while it remains live?+
We can prepare and test a new storefront while the existing store keeps trading. Product, CMS and compatible module-data migration, final data synchronisation and cutover are planned for your specific project.
Does the licence include hosting and a bespoke build?+
Hosting, migration, training and custom development are agreed separately. We can discuss Cloudways for Magento and Cloudflare for the frontend; you can pay the providers directly or request a managed quotation.
Latest release: Version 1.0.2
Product Shell Bundle is a Magento 2 module that serves pre-warmed, lightweight product records to a headless storefront over JSON and GraphQL, so listing and category pages render without a full product query per item.
Headless is only fast if the product page doesn't wait on Magento
The promise of a headless storefront is instant pages — but a product page needs a lot of data, and if the front end fetches all of it from Magento's GraphQL on every visit, you've just moved the slowness somewhere new. The trick the fastest headless stores use is to separate what changes rarely from what changes constantly: cache the product's stable "shell" and only fetch price and stock live. Product Shell Bundle gives you exactly that split, in one query.
One-shot product data · Pre-warm & cache · Price/stock stay live · Gallery · attributes · SEO · Reviews · options · variants · Single & bulk · Enabled-only, safe · Check release-specific Magento and PHP compatibility
| The whole shell, once | Name, slug, gallery, attributes, options, variants, category membership, reviews and SEO — in a single query. |
|---|---|
| Built to be cached | Shell data changes rarely, so your front end can pre-warm and store it, then serve product pages from cache. |
| Live where it matters | Price and stock are fetched separately as live server-island queries, so cached pages are never wrong. |
| One or many | Fetch a single product by SKU, or a bundle of products to warm a whole category's pages at once. |
What you'll use it for
- Reduce PDP data round-trips — serve slower-changing fields from cached shell data and request price and stock separately.
- Pre-warm at build or on demand — pull a bundle of products in one request to populate your cache ahead of traffic.
- Cut GraphQL round-trips — replace a dozen small queries per page with one, lightening load on Magento.
- Keep accuracy — request price and stock separately; verify their freshness against your cache rules and checkout values.
How it works
Comprehensive — and safe by default
It returns the full product shell, and only ever for products you actually sell. One productShellBundle query brings back galleries, attributes, configurable options and variants, custom options, category membership, reviews with ratings, and SEO fields — everything a product page needs except the two things that must be live. And both the bulk query and the single-SKU productShellSingle return only enabled products: a disabled or hidden product is never exposed through this public endpoint, so pre-warming your cache can't leak something that isn't meant to be live.
Specifications
| Queries | productShellBundle (many) and productShellSingle (by SKU) |
|---|---|
| Shell data | Name, slug, gallery, attributes, options, variants, custom options, category membership, reviews and ratings, SEO |
| Left live | Price and stock — fetched separately as server-island queries |
| Design | Slow-changing data in one shot, built for front-end caching / pre-warming |
| Safety | Enabled-only; disabled or hidden products never exposed |
| Delivery & licence | Composer install, per-domain licence key, updates via Composer |
Works with
Part of the AgenticEcom suite for Headless & Astro:
The sibling to the CMS Sync Bundle and Global Data Bundle; keep caches fresh with Astro ISR. Included in the AgenticEcom Suite.
Frequently asked questions
Why split product data into a "shell" and live data?
Most of a product page — images, attributes, descriptions, reviews, SEO — changes rarely, so it can be cached and served without a full product query. Price and stock change often, so they're fetched live. Splitting them can reduce page-data work while the storefront checks current price and stock.
What's in the shell bundle?
Name, slug, gallery, attributes, configurable options and variants, custom options, category membership, reviews with ratings, and SEO fields — everything except price and stock.
Can I warm a whole category at once?
Yes. The bundle query returns many products in one request, so you can pre-warm a category's product pages ahead of traffic, and fetch a single product by SKU when you need just one.
Could it expose a disabled product?
No. Both the bulk and single-SKU queries return only enabled products, so a disabled or hidden product is never served through this public endpoint.
Which Magento and PHP versions are supported?
Check release-specific Magento and PHP compatibility before installation.
SEE THE WHOLE PLATFORM
The capability is one part. AgenticSuite brings it together.
Keep Magento as your commerce engine. Shape the customer experience in Astro Admin, with an integrated module collection behind it.
A complete B2B catalogue.
Explore SyncComms: approximately 1,000 products, guided finders, category filters and a quotation journey.
Explore SyncCommsMobile scores achieved.
See the dated mobile lab reports linked from our homepage, or test the live sites yourself. Results depend on the page and test conditions.
View the performance evidenceMake the move while you trade.
We can scope migrations, frontend rebuilds and new stores. Hosting, migration, training and custom development are agreed separately.
Discuss your projectYOUR NEXT STOREFRONT STARTS HERE
See what AgenticSuite could do for your business.
Explore the working sites, watch the overview, then talk to us about your catalogue and the store you want to build.