Terrazza Documentation Contact support

Sections and blocks

In the theme editor, choose a template from the menu at the top, for example Home page, Products > Default product or Collections > Default collection. Then add, reorder, hide or remove sections in the sidebar. Most sections have a Color scheme setting (see Colors), so it is not repeated below.

Text fields marked "Heading" accept italic. An italic word is set in the serif italic, which is how Terrazza adds accents.

Announcement bar

A one-line message above the header.

Setting Notes
Text Keep it short; it is shown on one line on phones
Link Optional. The whole bar becomes a link

The logo sits in the center by default and stays centered whatever icons sit beside it. The menu opens as a full-screen drawer on every screen size, with room for a featured product or collection.

Setting Notes
Logo Leave empty to show the store name as a wordmark
Logo width 60–240 px
Logo position Center or Left
Menu The menu shown in the drawer. Up to three levels; links with sub-links open in place
Transparent over the home hero The header sits on top of the home page hero and turns solid once the page scrolls
Sticky header Always, On scroll up (hides while scrolling down, comes back when scrolling up) or Never

Menu feature card. A card at the bottom of the menu drawer. It shows only when Link and Heading are filled in.

Setting Notes
Image Small portrait thumbnail
Subheading Small uppercase line, for example "New finish"
Heading For example "Terra in Olive"
Link label For example "Shop the color"
Link Where the card goes
Secondary menu A second, smaller list of links in the drawer, for example About, Delivery and Contact

The header icons open the account page, the search drawer and the cart.

Setting Notes
Show newsletter signup A newsletter band at the top of the footer. Signups are saved as customers who accept email marketing
Heading, Text The newsletter band's copy
Newsletter color scheme The band's colors. Ink (dark) by default
Show country/region selector Shown when the store sells in more than one country (Settings > Markets)
Show language selector Shown when the store has more than one published language
Show Follow on Shop Customers can follow the store in the Shop app. Requires the Shop channel and Shop Pay
Show payment icons The payment methods enabled in your store

Link list blocks (up to 4): each one has a Heading and a Menu. Social icons come from Theme settings > Social media.

Sections you can add to any page

Hero

A full-bleed image with a headline and a button. It is meant for the top of the home page.

Setting Notes
Image Landscape, 2400 px wide or more
Mobile image Used on portrait phones, narrower than 2:3. Leave empty to crop the main image
Height Full screen, Large or Medium
Subheading Small uppercase line above the headline
Heading First line of the headline
Second line Appears after the heading. Use italic to set a word in the serif italic
Button label, Button link The button shows when both are filled in

Collection list

Collections as tall image tiles, for example "Balcony, Terrace, Garden, Indoors".

Setting Notes
Subheading, Heading Section title
Collection blocks (up to 12) Collection, plus optional Name and Image that override the collection's own title and image

A row of product cards from one collection.

Setting Notes
Subheading, Heading Section title
Collection Defaults to all products
Products to show 2–12
Show View all link Links to the collection

Cards show the product's swatches (see Swatches). Choosing a swatch changes that card's image, price and link.

Shop by finish

A row of round finish swatches. Each one opens a collection already filtered to that color, so shoppers can start with the finish they want.

Setting Notes
Subheading, Heading Section title
Collection The collection each swatch opens, filtered by color. Defaults to all products
Color filter parameter The URL parameter of the store's Color filter, for example filter.v.option.color. Add the Color filter in Search & Discovery first. Leave empty to link to the plain collection
Finish blocks (up to 8) Filter value: the color exactly as it appears in the color filter, for example Terracotta. Label: optional display name. Swatch image: a close-up of the material

To find the filter parameter, open a collection in your store, choose a color in the filter, and copy the part of the address before =. See Filters.

Material story

A material guide: a large image beside a headline, a short spec list and a link.

Setting Notes
Image A close-up of the material, or the product in use
Subheading, Heading For example "Why fiber concrete lasts for decades"
Button label, Button link For example a link to a blog post about the material
Spec blocks (up to 8) Label and Value, for example "Frost resistant" / "to −4°F / −20°C"

Story card

An editorial card: a portrait image with a subheading, a serif heading and a link. Use it to point to a guide, a blog post or a collection. The same card can also be placed inside a collection grid; see Collection.

Setting Notes
Image Portrait
Subheading, Heading Wrap a word in italics for the serif accent
Link label, Link

Image with text

An image beside a heading, text and a button. On phones the image comes first.

Setting Notes
Image
Image position on large screens Left or Right
Subheading, Heading, Text
Button label, Button link

Multicolumn

Up to six short promises in a row, each with an icon, for example delivery, returns and durability.

Setting Notes
Heading Read by screen readers only; it names the section for them
Column blocks (up to 6) Icon (None, Truck, Drop, Return, Check, Bag or Heart), Heading and Text

Rich text

A heading, text and an optional button, for a brand note or an introduction.

Setting Notes
Subheading, Heading, Text
Button label, Button link
Alignment Left or Center

FAQ

Questions and answers that open and close. Terrazza also publishes them as FAQ structured data, which helps search engines and AI assistants quote your answers.

Setting Notes
Subheading, Heading
Question blocks (up to 20) Question and Answer

Use FAQ sections on pages where the answers are visible to everyone. Avoid repeating the same questions on many pages.

Video

Setting Notes
Subheading, Heading
Shopify-hosted video Plays with the browser's controls. Takes priority over the video link
YouTube or Vimeo link Shows the cover image and a play button. The video loads when someone presses play, which keeps the page fast
Cover image Shown before a YouTube or Vimeo video plays

Newsletter

An email signup as its own section, separate from the one in the footer.

Setting Notes
Subheading, Heading, Text

One product with its gallery, price, variant picker and buy buttons, for example on the home page.

Setting Notes
Product
Blocks Title, Price, Variant picker, Buy buttons, Description, Text, Custom Liquid and app blocks. Their settings are the same as on the product page

Custom Liquid

Setting Notes
Liquid code Add app snippets or other Liquid code to create advanced customizations
Top padding, Bottom padding 0–100 px

Code added here is not covered by theme support (see Support).

Product page

Open Products > Default product in the editor. The Product section holds the blocks below; reorder them by dragging.

Section setting Notes
Show the sticky add-to-bag bar A slim bar with the price, the selected variant and the add button. It appears once the main button scrolls out of view

The gallery shows product images, videos (Shopify-hosted, YouTube and Vimeo) and 3D models. On phones the media is full width, edge to edge. When a shopper picks a variant, the gallery crossfades to that variant's image.

Title

Setting Notes
Show vendor Small uppercase line above the title
Show subtitle Italic line under the title, from the Subtitle metafield. If that is empty, the product type is used

Price

Setting Notes
Show tax note For example "Taxes calculated at checkout"

Sale prices show the compare-at price struck through.

Variant picker

Shows each option with two or more values:

Picking a value updates the gallery, price, availability, the "Will it fit?" block, the sticky bar and the page address (?variant=). Without JavaScript the picker still works as a form.

Buy buttons

Setting Notes
Show quantity selector
Show accelerated checkout Shop Pay, Apple Pay and the other buttons the store has enabled

Subscription options show here when the product has selling plans. Gift card products get a recipient form.

Pickup availability

Shows whether the selected variant can be picked up at a location, and how soon. Turn on local pickup in Settings > Shipping and delivery first.

Dimensions ("Will it fit?")

A line drawing of the product's shape with the measurements of the selected variant: diameter, width, length (depth), height and weight. An optional fit note sits underneath.

Setting Notes
Units Theme setting (default), Imperial first, Metric first, Imperial only or Metric only. Overrides the theme setting for this block

The block needs the dimension metafields. It hides itself for products without dimensions. Setup: Product metafields > Dimensions.

Delivery cards

Three soft cards for delivery, durability and returns.

Setting Notes
Delivery method Used when the product has no Delivery method metafield. Default "Free curbside delivery"
Lead time Used when the product has no Lead time metafield. Default "Ships in 3–5 business days"
Durability heading, Durability text Default "Weather resistant" / "Made for the outdoors". The Durability title and Durability text metafields override them per product
Returns heading, Returns text Default "30-day returns" / "Free and easy"

Change the defaults to match your real delivery and returns terms before you publish.

Product details

An accordion with up to four rows. A row hides itself when it has no content.

Row Content
Details The product description
Materials & care The Material and care metafield
Delivery & returns The Delivery method and Lead time metafields, followed by a returns line. Edit the returns line in Edit default theme content (search for "Returns are accepted")
All dimensions One line per size with all its measurements

Description and Text

Custom Liquid and apps

Add Custom Liquid for small snippets, and app blocks from apps you install, such as reviews.

Pairs well with

A section below the product with complementary products, scrollable sideways on phones. The products come from Search & Discovery > Recommendations > Complementary products. Until you set them up, the section stays hidden.

Setting Notes
Products to show 2–10

Products Shopify recommends based on what shoppers buy and view together.

Setting Notes
Products to show 2–10
Fill with products from the same collections Shopify returns few related products on a small catalog. When this is off, only Shopify's recommendations show

Collection, search and collections list

Collection

Setting Notes
Products per page 2–48
Show collection description
Show collection image
Show sort

Filter opens a drawer with the store's Search & Discovery filters. Color filters show as swatches. When a color filter is active, every card opens on its matching finish. Filters and sort also work without JavaScript. See Filters and recommendations.

Story card block. Add a Story card block to place an editorial card inside the product grid.

Setting Notes
Position in the grid 1–24. The grid cell the card occupies; a shorter grid shows it last
Image, Subheading, Heading, Link label, Link As in the Story card section

Search results

Setting Notes
Results per page 2–48
Show sort

Search results have the same filters as collections.

The search icon opens a drawer that suggests products, collections, pages and articles while the shopper types. Without JavaScript, the icon goes to the search page.

Collections list

The page at /collections.

Setting Notes
Collections per page 4–48
Show product count

Cart

See Cart and free shipping.

Blog, article, pages and other templates

Blog posts

Setting Notes
Articles per page 1–24
Show article images, Show excerpts, Show dates

Article

Setting Notes
Show featured image, Show author, Show tags
Show previous and next article links
Comments per page 1–20. Comments appear when they are turned on for the blog

Page and Contact

404, Password and Gift card