Documentation menu

Sections

Sections are the large parts of a page. In the theme editor, click Add section to see the sections you can add to the current page, grouped by category. This page lists every section in Weft. For the blocks that go inside them, see blocks.

Most sections share three settings that aren't repeated below: Color scheme, Top padding and Bottom padding.

Category in "Add section"Sections
BannersHero
Made to orderFabric strip, Fabric library, Showroom
CollectionsCollection list, Featured collection
TextRich text, Multicolumn, Testimonials
Text and imagesImage with text
ProductsShop the room
ProductFeatured product, Product details, Complete the set, Recommendations, Recently viewed
MediaVideo
FormsNewsletter, Contact form
AdvancedCustom Liquid

Some sections belong to one template and can't be added elsewhere. They're listed under Template sections.

Announcement bar #

One line of text at the top of every page, with an optional link. No scrolling text, no rotation. It sits in the header group.

SettingWhat it does
TextThe message.
LinkOptional.
Link labelShown after the text when there's a link, for example "Order samples".

Logo, main menu, search, account, cart, and the country and language selectors. The settings are in three groups: Navigation, Country and language, and Behavior.

SettingWhat it does
Logo imageWithout an image, the store name is set in the heading font.
Logo textLeave empty to use the store name.
Logo width60 to 320 px.
Main menuLinks with sub-links open a mega menu. Sub-links with their own links become columns.
Main menu position on desktopRight, next to the icons, or Center.
Show "Shop all" links in menusAdds "Shop all Sofas" at the end of a mega menu and the matching drawer submenu, when the top-level link goes to a collection or to all products. Links to pages and other content never get one. Turn it off if your menus already have their own "All sofas" links.
Show collection images in mega menusFor top-level links to a collection. A "Main menu feature" block overrides the image.
Mega menu, drawer and search color schemeScheme for the mega menu, the mobile menu and the search panel.
Customer account menuThe menu shown in the account pop-up.
Show country/region selector, Show language selectorShown when the store sells to more than one country or region, or has more than one published language.
Sticky behaviorOff, Always, or When scrolling up.
Transparent over a full-width heroApplies on pages that start with a hero section set to full width. The header turns solid after a short scroll or when a menu opens.
Text and icons on the transparent headerUsually white.

Main menu feature block: adds an image with a caption to one mega menu. Set Main menu link to the name of a top-level main menu link with sub-links, for example "Sofas". Up to 8.

A mega menu under Sofas with three columns of links and a featured image
Mega menu with a Main menu feature block

Menus with three levels work: top-level links open the mega menu, second-level links become column headings and third-level links are listed below them. On phones, the menu opens in a drawer with one accordion per top-level link.

Blocks: About (heading, text and Show social media icons; one per footer), Footer menu (a heading and the menu to show; add several), Text, Newsletter (one per footer) and app blocks. The bottom row has the country and language selectors, the copyright line and payment icons.

SettingWhat it does
Show payment iconsIcons for the payment methods you've turned on.
Show Follow on Shop buttonLets customers follow your store in the Shop app. Shop Pay must be turned on.
Copyright nameLeave empty to use the store name.
Show country/region selector, Show language selectorAs in the header.

Home page and content sections #

Hero #

The large banner at the top of a page. Up to 6 blocks (Heading, Text, Button and others).

SettingWhat it does
LayoutText beside the image, Full width, text over the image, or Text, image and material grid (a grid of fabric swatches beside the image).
Swatches in the grid, Fabrics from a productFor the material grid: how many swatches, and which product's fabrics to show. Leave the product empty to use the first entries of your fabric list. The grid is hidden on the live store until fabric entries exist.
Image, Mobile imageThe mobile image is optional and shows on screens narrower than 750 px.
Image descriptionFor screen readers. Leave empty to use the image's alt text.
Height on desktopSmall, Medium, Large or Fill the screen.
Image positionRight or Left, for the side-by-side layout.
Show the text above the image on mobileFor the side-by-side and grid layouts.
Shade behind the text0 to 80%, for the full-width layout.
Text alignmentLeft or Center.
Color schemeFor the full-width layout, pick a scheme with light text.

When the hero is the first section, its image loads first. Keep one hero per page at the top.

Fabric strip #

A row of fabric swatches beside a heading and buttons, for example "Over 140 fabrics" and "Order samples". Up to 5 blocks.

SettingWhat it does
Fabrics from a productShows the product's fabrics in their order. Leave empty to show the first entries of your fabric list.
Layout on desktopHeading and buttons beside the swatches, or Heading, swatches and buttons in one row.
Fabrics to show3 to 10.
ImageLarge image, then swatch; or Swatch image.
Show fabric namesNames under the swatches.
Rule aboveA hairline above the section.

Without fabric entries the section is hidden on the live store. See fabrics.

Collection list #

Category cards, for example Sofas, Beds and Chairs. Add one Collection block per card (up to 8).

SettingWhat it does
Heading, Link label, LinkOptional heading and a "view all" link.
Columns on desktop2 to 5.
Image shapeWide, Landscape, Classic, Square or Portrait.
CaptionCentered below the image, Bar with an arrow, or Over the image.
Mobile layoutSwipe or Stack.

Each Collection block has Collection, Image (leave empty to use the collection image), Caption (leave empty to use the collection title) and Link (leave empty to link to the collection).

Product cards from one collection, with a heading and buttons above them. Up to 5 blocks.

SettingWhat it does
CollectionUntil you choose one, example cards are shown.
Products to show2 to 16.
Columns on desktop2 to 5.
LayoutGrid or Carousel.
Mobile layoutSwipe or Two columns (grid layout only).

Cards follow Theme settings > Product cards.

Rich text #

Centered or left-aligned text blocks, for example a short statement between two sections. Up to 8 blocks.

SettingWhat it does
AlignmentLeft or Center.
Content width20 to 70 rem.
Rule aboveA hairline above, for lines like "Handmade in 8 to 10 weeks".

Image with text #

An image beside text blocks. Up to 8 blocks.

SettingWhat it does
Image, Image descriptionLeave the description empty if the image is decorative.
Image positionLeft or Right.
Image widthHalf or Large.
Image shapeLandscape, Classic, Square or Portrait.
Text alignmentLeft or Center.

Multicolumn #

Text columns, for example delivery, samples and guarantee. Add Column blocks (up to 6). Each column has an optional Icon (Swatch, Clock, Ruler, Delivery, Hand, Leaf, Location, Chat, Return, Sofa) or Image, a heading, text and a link.

SettingWhat it does
HeadingOptional section heading.
Columns on desktop2 to 4.
AlignmentLeft or Center.
Rule above each columnA hairline over each column.

Shop the room #

A room photo with a dot on each product. A dot opens a small card with the product's name, price and link. Beside the photo, a list shows every product, the room total and an "Add all to cart" button. Up to 8 Hotspot blocks.

Shop the room: a living room photo with three dots, a card open for the Wren lounge chair, and a list of three products with "Add all 3 pieces to cart"
Shop the room
SettingWhat it does
Image, Image descriptionThe room photo and its description for screen readers.
Image shapeLandscape, Classic or Square.
Image positionLeft or Right.
Heading, TextShown beside the image.
Show "Add all to cart"Adds each product's first available variant. The list shows which variant that is.

Each Hotspot has Product, Horizontal position and Vertical position (0 to 100%). Hotspots without a product are hidden on the live store. Until at least one hotspot has a product, the live store shows only the photo, heading and text, and the theme editor shows placeholder rows where the products will go.

Testimonials #

Customer or press quotes. Add Quote blocks (up to 6) with Quote, Name, Publication or product and an optional Publication logo that replaces the publication name.

SettingWhat it does
HeadingDefault "What people say".
LayoutColumns with rules, Columns, or One large quote.
Columns on desktop1 to 4.

On phones, the quotes swipe sideways. Nothing moves on its own.

A new Quote block starts empty. The theme editor shows placeholder text in it, and the live store leaves it out until you write the quote. If no quote has text, the whole section stays hidden on the live store.

Showroom #

An image beside your showroom details: a heading, text, Location blocks and a button. Up to 10 blocks. Each Location block has Name, Address, Opening hours and Directions link (a link to the address on a map service).

SettingWhat it does
Image, Image descriptionA photo of the showroom.
Image positionLeft or Right.

Video #

A video with a poster image and a play button. The video loads only when the shopper presses play. Up to 4 blocks over or beside it.

SettingWhat it does
VideoUpload a video, or use a YouTube or Vimeo link below.
YouTube or Vimeo linkUsed when no video is uploaded. YouTube videos load from the privacy-enhanced domain.
Description for screen readersDescribes the video for screen readers.
Poster imageShown until the video plays. Defaults to the video's preview image.
Play muted in a loop when in viewOff by default. Shoppers can pause it.
ShapeWidescreen, Cinema or Classic.
Full widthEdge to edge.

Newsletter #

An email signup that adds customers to your Shopify customer list with marketing consent. Up to 5 blocks.

SettingWhat it does
LayoutCentered, or Text and form side by side.
Field styleUnderline or Box.
Button labelLeave empty to show an arrow.

Contact form #

A contact form with name, email, optional phone and topic menu, and message. Blocks on the left side hold text and Location blocks. Up to 8 blocks. Shopify sends each message to your store's contact email.

SettingWhat it does
HeadingDefault "Send us a message".
Show phone number fieldAdds an optional phone field.
Show topic selector, TopicsA menu of topics. Enter one topic per line.
Note beside the buttonFor example how soon you reply.
Message after sendingShown after the form is sent.

Custom Liquid #

Adds your own Liquid, HTML or app code. Available on every page.

SettingWhat it does
Liquid codeAdd app snippets or other code. Liquid has access to the page's objects.
Full widthIgnore the page margins.

Product page sections #

Product #

The main product section: the gallery on one side and the buy column on the other. The buy column holds blocks: Product title, Price, Lead time, Variant picker, Buy buttons, Dimensions, Description, Sticky add to cart, Custom Liquid, app blocks and the general content blocks. See blocks.

SettingWhat it does
Gallery width on desktopHalf, Large or Extra large.
Gallery position on desktopInside the page margins, or To the edge of the screen (the gallery meets the header and the screen edge).
Keep the buy column in view while scrollingThe buy column stays in view next to a long gallery.

Combined listings (Shopify Plus): when a shopper picks an option value that belongs to another product in a combined listing, the section loads that product in place, with its gallery, title, price, options and buy buttons, and the page address changes to it. The sections below the product follow.

One product with its gallery and buy column, for the home page or any other page. It takes the same blocks as the Product section, so shoppers can pick a fabric and add to cart without leaving the page. The title links to the product page.

SettingWhat it does
ProductThe product to show.
Gallery width on desktopHalf, Large or Extra large.
Image position on desktopLeft or Right.

Product details #

A heading column and collapsible Detail row blocks (up to 12) for the description, dimensions, materials and care, delivery and your own text. See dimensions and detail rows.

SettingWhat it does
HeadingDefault "The details".
TextOptional text under the heading.
ImageOptional. Shown under the heading on desktop.

Complete the set #

The other products in the product's group. See complete the set.

Recommendations #

Product cards that Shopify recommends for the current product. The section loads shortly before it scrolls into view.

SettingWhat it does
HeadingDefault "You may also like".
ProductsRelated: picked by Shopify from your store's data. Complementary: products you choose per product in the Search and Discovery app.
Products to show2 to 10.
Columns on desktop2 to 5.

When there are no recommendations, the section takes no space on the live store. New stores often have no related products yet: Shopify needs some order history. Complementary products show as soon as you set them in Search and Discovery.

Recently viewed #

The products a shopper looked at most recently, newest first, without the current product. The list is kept in the shopper's browser, not on your store. The section stays hidden until they have viewed another product. It's also on the cart page.

SettingWhat it does
HeadingDefault "Recently viewed".
Products to show2 to 8.
Columns on desktop2 to 6.

Products hidden from your store's search don't appear here, because the section looks them up through search.

Template sections #

These sections belong to one template. See templates for where each one is used.

Collection banner #

The top of a collection page: title, description and an image. Settings: Show description, Show image, Image (leave empty to use the collection image), Layout (Text and image side by side, or Wide image above the heading) and Image shape (Panorama, Wide or Landscape).

Product grid #

The products on a collection page, with filters and sorting.

A collection page with availability and price filters in a sidebar and product cards with swatches and lead times
Product grid with filters
SettingWhat it does
Products per page6 to 48.
Columns on desktop2 to 4.
Columns on mobile1 or 2.
Pagination"Load more" button or Page numbers.
Filters and sorting > Show filtersSet up filters in the Search and Discovery app.
Filters on desktopSidebar or Drawer. On phones, filters always open in a drawer.
Show sortingA sort menu above the grid.

Search results #

The search page: a search field, then results with the same filters, sorting and pagination as the product grid. Settings match the Product grid, with Results per page.

The predictive search panel: products for "harlow" with prices, and a link to all results
Suggestions while typing, from Theme settings > Search

Cart #

The cart page. Product lines show their options with fabric swatches and the live lead time. Samples are grouped below them.

SettingWhat it does
Show the longest lead timeThe longest lead time of the products in the cart. Updates as the cart changes.
Lead time noteDefault "Your order ships together when the last piece is ready."
Show order noteA note field the shopper can open. It saves as they type.
Show dynamic checkout buttonsShows the express payment methods you have turned on, such as Shop Pay.
Continue shopping linkOptional.
Empty cart > Heading, Text, First link label, First link, Second link label, Second link, Third link label, Third linkWhat an empty cart shows, with up to three links.

Cart drawer #

The cart that slides in from the side. It has no settings of its own: it follows Theme settings > Cart and Drawers and dialogs in Colors.

Fabric library #

See fabric library page.

Page #

The title and content of a page. Settings: Alignment, Text width (30 to 60 rem), Image and Image shape.

Blog posts #

A blog's list of posts: tag links, the newest post as a large feature on the first page, then a grid. Settings: Feature the newest post, Show tag links, Posts per page (4 to 24), Columns on desktop.

Blog post #

One article: blog link, date, author, reading time, image, the text, tags, comments (when the blog allows them) and three more posts. Settings: Image shape, Show author, Show reading time, Show more posts from the blog.

Collections list #

All collections as image tiles. Settings: Heading, Text, Collections (leave empty to show every collection with products), Collections per page (6 to 48, when the collections setting is empty), Order (As picked above, Alphabetical, Most products first, Fewest products first), Columns on desktop, Image shape, Show product count.

Page not found #

The 404 page: heading, text, a search field, up to three links and an image. Settings: Heading, Text, Show search, First link label, First link, Second link label, Second link, Third link label, Third link, and Image.

Password page #

What visitors see while your store is password protected: store name, heading, message, an image, a newsletter signup and the password form behind "Store owner? Enter the password".

SettingWhat it does
Store nameLeave empty to use the store name.
HeadingDefault "Opening soon".
MessageUsed when the password page has no message in Online Store preferences.
Show newsletter signup, Signup note, Button labelThe signup form.

Sections without settings #

Fabric dialog (the "View all fabrics" panel) and Predictive search (the search suggestions) are loaded by the theme when a shopper opens them. They don't appear in the editor's section list.