Integrations → Fourthwall: save your storefront token and checkout URL. Insert Store collection on a page, pick a Fourthwall collection, publish. Visitors browse `/shop/{handle}`, add to cart from the floating chrome, and checkout on Fourthwall.
Before you start
You need:
A Fourthwall shop with at least one published product in a public collection
A storefront token (ptkn_…) from Fourthwall → Settings → For Developers
Your shop checkout domain (for example your-shop.fourthwall.com) — used for the checkout redirect
Aveiro uses Fourthwall’s Storefront API (read-only catalog + cart). You cannot create or edit products inside Aveiro.
Connect Fourthwall
Open your site in the editor.
Click Integrations on the rail.
Under Fourthwall, click Set up (or the edit icon if already connected).
Enter:
Storefront token — paste the full token from Fourthwall
Checkout URL — your shop domain (with or without https://)
Click Test connection to confirm Aveiro can reach your catalog.
Click Save.
After save, open or refresh Store collection settings — the collection dropdown should list your Fourthwall collections.
Credentials and security
The storefront token is encrypted at rest on Aveiro’s servers.
Only a masked preview of the token is shown after save.
To rotate a token, open the integration panel, enter a new token, test, and save again.
Editor vs live site
You can connect Fourthwall and preview store blocks while editing, even before your next publish. The published site uses the same connection once pages are live.If collection lists look empty right after connecting, save the integration and reopen the Store collection settings panel — the editor refreshes collections when the connection updates.
Add products to a page
Open Components and filter by Integrations (or search Store collection).
Insert Store collection on the page.
Select the block and configure:
Setting
Purpose
Collection
Fourthwall collection handle — use `all` for your full catalog
Layout
Grid, column, or row of product cards
Columns
Grid column count (1–6) when layout is Grid
Max products
Cap how many products load (1–100)
Show title / Show price
Toggle text on each card
Publish the page when ready.
Finding a collection handle
In Fourthwall, open Products → Collections, select a public collection, and copy the handle from the URL (the slug after /collections/). The special handle all includes every published product.
What visitors see
Collection grid
Product cards show the featured image, title, and starting price. Tapping a card opens the product on your site.
Product detail (/shop/{handle})
Each product page includes:
Image carousel
Title and price (updates when variants change)
Variant selector when the product has options
Add to cart
Description (formatted with your site typography)
Related products — other items from the same collection, when available
Accordion sections for shipping and policies
Product URLs work on Aveiro preview domains and custom domains connected in site settings.
Cart and checkout
After the first add-to-cart:
A cart button appears in the visitor chrome (same corner as login and support chat when those are enabled)
The cart dropdown lists items and subtotal
Checkout sends the visitor to Fourthwall’s hosted checkout with the cart already loaded
Aveiro does not process card payments or order fulfillment — Fourthwall handles both after checkout.
Publish checklist
Step
Why
Fourthwall connection saved
Catalog and cart APIs require credentials
Store collection page published
Visitors need the grid on a live route
Site settings published (if you changed SEO/domain)
Custom domain and metadata apply to shop URLs too
Smoke-test add to cart + checkout
Confirms checkout URL and token on production
Troubleshooting
Symptom
What to check
Test connection fails
Token copied in full; products exist; collection is public in Fourthwall
Collection dropdown empty in editor
Save integration first; reopen component settings after save
No products on live site
Page is published; collection handle is correct; products are published in Fourthwall
Cart never appears
Add at least one item; Fourthwall must stay connected for the site
Checkout error
Checkout URL matches your Fourthwall shop domain
Integrations tab missing
Your account may not have Fourthwall access yet — contact admin
Limits and expectations
Catalog source — Products always come from Fourthwall; Aveiro does not host inventory.
Checkout — Always Fourthwall-hosted; custom checkout flows are not supported.
Related products — Shown when other products share the same Fourthwall collection; there is no separate “recommendations” API.
Digital downloads — Fourthwall physical merch on /shop/{handle}; native Aveiro digital products use /products/{slug} and are documented in Products.
