Kyoto theme · Documentation · v1.0.0

Collection page

To edit collection pages, open the theme editor and choose Collections > Default collection from the page menu at the top. The page has two sections by default: the Collection banner and the Product grid. Every setting with its full range is listed in Collection, search and list pages.

Collection banner

The banner shows the collection's name, image and description.

SettingChoices or rangeNotes
Show collection imageOn or offUses the image set on the collection in the Shopify admin.
Image placementBeside, Overlay, Above, Color field with a shelf
HeightSmall, Medium, Large, Full screen, Adapt to imageWith Overlay.
Overlay opacity0 to 80 %With Overlay. Darkens the image so text stays readable.
Content positionNine positions, from Top left to Bottom rightWith Overlay.
Heading sizeSmall, Medium, Large, Display
Content alignmentStart, Center
Show description, Show product countOn or off
Subcollections, Subcollections styleCollections; Chips or ImagesLinks to related collections under the heading.
Display headingTextA large line above the collection name, such as an English word. Connect it to a collection metafield to give each collection its own.
Feature numberTextShown as "No.03" above the name. Connect it to a collection metafield to number each collection.
Chapter openerOn or offWhen the collection is linked from the top level of the main menu, the heading shows its chapter number and the menu item's name.
A collection banner set to “Color field with a shelf”: lucky charms standing on a shelf over a pale pink field

The color field with a shelf

With Image placement set to Color field with a shelf, the banner becomes a pale color field with some of the collection's products standing on a shelf.

  • Products on the shelf: 2 to 6.
  • Shelf piece size: Small, Medium, Large.
  • Field color: leave it blank to use the collection metafield custom.field_colour, then the palette's blush color.

Each product stands as its custom.cutout picture (a .png with a transparent background, free on the field with a soft shadow), or as its first photo blended into the field. Photos on a white background blend best; the edges of every photo fade out, so a grey or cream background never shows as a rectangle. For products that stand free with their own shadow, add a cut-out. See Metafields.

Product grid

The product grid in the demo store with First product large turned on: the first product takes four cells and a promo tile sits between the products
SettingChoices or rangeNotes
Columns on desktop2 to 6
Columns on mobile1, 2
Products per page8 to 48, in steps of 4
PaginationPage numbers, Load more, Infinite scrollPage links always stay in the page, so search engines and shoppers without JavaScript reach every product. Infinite scroll pauses after three automatic loads, and coming back from a product returns shoppers to where they were.
Enable filteringOn or off
Filter layoutSidebar, Drawer, HorizontalOn phones, filters open from the bottom.
Show filter countsOn or off
Show more after (values)3 to 20Long filter lists collapse after this many values.
Open filter groupsNone, First only, AllWith Sidebar.
Enable sortingOn or off
Show column switcherOn or offLets shoppers change the number of columns.
Sidebar menuMenuA list of links above the filters, for example your other collections. Give it a Sidebar menu heading, and choose Sidebar menu on mobile (Drawer or Scroll).
Card image ratio, Card hover effectOverride the theme settings for this grid.

Filters

Kyoto uses Shopify's own storefront filters. Choose which filters appear (availability, price, product type, vendor, options such as color or size, or metafields) in the Shopify Search & Discovery app, under Filters. Color filters show swatches when your option values have colors.

The filter drawer open on a collection page: availability and price filters with a button to show the results

Grid look

The Grid look block is always part of the Product grid. Select it in the sidebar to change how the grid feels.

SettingChoicesWhat it does
First product large (2 × 2)On or offThe first product takes four cells. Only on the first page, without filters and in the collection's own order, with 3 or more products and columns.
Photos on pale color fieldsOn or offFor photos on a white ground: the white becomes a pale color field and the real shadow stays.
Field colorsPalette colors in turn, SingleWith Single, choose the Field color. A product's custom.field_colour metafield always wins.
Name and price under the pictureOn or offUnder every picture, whatever the card style.
Product name sizeUse theme setting, Medium, Large, Extra large
Row spacingUse theme setting, Medium, Large, Extra large
MotionNone, Subtle, Bold

When Card style in Theme settings > Product cards is Color field, label plate beside the object, turn on Adjust the label plate card in this block to size the cards: Color field shape (Square, Landscape, Wide), Label plate width (28 to 50 %), Product name size on the plate (Small, Medium, Large, Extra large), Price size on the plate (Small, Medium, Large), Object size (60 to 100 %), Object’s foot in the photo (60 to 100 %, default 82) and Floor line (None, Thin, Medium, Thick).

Promo tiles

Add Promo tile blocks to the Product grid to place an image, a video, a color, a product, a collection or an article between the products.

  • Position in grid: 1 to 48 (under Show more settings).
  • Column span: 1 or 2.
  • Hide when filtered: hides the tile while a filter is active, so it never sits between filtered results.
  • Content position and Overlay opacity (0 to 80 %).

Collection description

To show a long collection description under the products instead of above them, turn off Show description in the Collection banner, then add the Collection description section under the Product grid. Set its Maximum width.

Product comparison

Turn on Show compare checkbox in Theme settings > Product cards (under Show more settings), then add the Product comparison section to the collection page or to a page. Shoppers tick up to four products and compare them row by row. Choose the rows with Compare row blocks: price, rating, vendor, type, an option or a metafield.

Collections list page

The page at /collections lists all your collections, or the ones you choose. Choose it in the theme editor under Collections list. Settings: Source (All, Selected), Sort order, Collections per page (8 to 48), Columns on desktop (2 to 6), Columns on mobile (1, 2), Collection card style, Show product count and Layout (Grid, Contents).