Kyoto theme · Documentation · v1.0.0

Cart, blog and other pages

The cart page, the blog and article pages, and the remaining page types.

Every size setting is listed with its full range or its choices and the default. A dagger (†) marks a setting that appears only after you choose a related option. “Other settings” lists the remaining options by their name in the theme editor.

Cart page

Cart

The cart page. Lines, totals, gift options and the checkout button are blocks shared with the cart drawer.

Other settings: Layout, Sticky order summary.

Also has the standard section settings.

Blocks you can add

  • Free shipping progress block
    • Other settings: Style, Success message.
  • Cart items block
    • Image ratio: Adapt to image, Portrait, Tall, Square, Landscape, Wide (default Square).
    • Other settings: Show vendor, Show low stock, Low stock threshold.
  • Order note block
    • Other settings: Open by default, Maximum characters.
  • Gift options block
    • Other settings: Show gift wrap, Show message field, Message character limit, Show hide prices option, Name saved on the order: gift message, Name saved on the order: packing slip, Value saved on the order: packing slip.
  • Noshi (Japan) block
    • Other settings: Name saved on the order: noshi, Name saved on the order: name on noshi.
  • Delivery date (Japan) block
    • Other settings: Name saved on the order: delivery date, Name saved on the order: delivery time.
  • Subtotal block
    • Other settings: Show savings.
  • Terms agreement block
    • Other settings: Page.
  • Checkout button block
    • Other settings: Show total on button, Show payment icons.
  • Recommendations block
    • Other settings: Heading, Recommendation type, Number to show, Layout, Hide when already in cart, Product.
  • Shipping estimate block
    • Other settings: Open by default, Show postal code field.
  • Trust points block
    • Other settings: Item 1 icon, Item 1 text, Item 2 icon, Item 2 text, Item 3 icon, Item 3 text, Layout.
  • Cart promotion block
    • Other settings: Image, Heading, Text, Link, Show when.
  • Text (shared block, see Shared blocks)
  • Custom liquid (shared block, see Shared blocks)
  • App blocks from apps you install

Blog and articles

Blog

The list of articles of a blog, with tag filters and an optional sidebar.

Sizes and layout

  • Columns on desktop †: 1 to 4 (default 3).
  • Article image ratio: Use theme setting, Adapt to image, Portrait, Tall, Square, Landscape, Wide (default Use theme setting).

Other settings: Layout, Articles per page, Pagination, Show tag filters, Sidebar position, Sticky sidebar, Sidebar on mobile.

Also has the standard section settings.

Blocks you can add

  • Text (shared block, see Shared blocks)
  • App blocks from apps you install

Fixed blocks (always part of the section; select them in the sidebar to change them)

  • Sidebar block
    • Recent articles block
      • Other settings: Number to show, Show images, Blog.
    • Tags block
      • Other settings: Number to show.
    • Table of contents block
      • Other settings: Heading, Heading levels.
    • Products block
      • Other settings: Heading, Products.
    • Search block
      • Other settings: Search articles only.
    • Image (shared block, see Shared blocks)
    • Text (shared block, see Shared blocks)
    • Email signup (shared block, see Shared blocks)
    • Social media links (shared block, see Shared blocks)
    • App blocks from apps you install
    • Issue box block
      • Other settings: Text above heading, Product, Issue number, Heading, Text, Button label, Show more settings, Front cover, Second cover, Third cover, Link.

Article

One article with reading progress, table of contents, tags, sharing, featured products and comments.

Sizes and layout

  • Content width: Narrow, Normal, Wide (default Narrow).

Other settings: Layout, Show reading time, Show reading progress, Reading progress style, Sidebar position, Sticky sidebar, Sidebar on mobile.

Also has the standard section settings.

Blocks you can add

  • Article image block
  • Table of contents block
    • Other settings: Heading, Heading levels.
  • Tags block
  • Share block
  • Featured products block
    • Other settings: Heading, Products.
  • Previous and next block
    • Other settings: Show images.
  • Comments block
    • Other settings: Comments per page.
  • Text (shared block, see Shared blocks)
  • App blocks from apps you install
  • Issue box block
    • Other settings: Text above heading, Product, Issue number, Heading, Text, Button label, Show more settings, Front cover, Second cover, Third cover, Link.

Fixed blocks (always part of the section; select them in the sidebar to change them)

  • Sidebar block
    • Recent articles block
      • Other settings: Number to show, Show images, Blog.
    • Tags block
      • Other settings: Number to show.
    • Products block
      • Other settings: Heading, Products.
    • Search block
      • Other settings: Search articles only.
    • Image (shared block, see Shared blocks)
    • Text (shared block, see Shared blocks)
    • Email signup (shared block, see Shared blocks)
    • Social media links (shared block, see Shared blocks)
    • App blocks from apps you install
    • Also takes these blocks, described above: Table of contents, Issue box.
  • Article title block
  • Article content block

Pages

Page

The text of a page written in the Shopify admin, with an optional table of contents and sidebar.

Sizes and layout

  • Content width: Narrow, Normal, Wide (default Narrow).

Other settings: Show heading, Heading alignment, Sidebar position, Sticky sidebar, Sidebar on mobile.

Also has the standard section settings.

Blocks you can add

  • Text (shared block, see Shared blocks)
  • App blocks from apps you install
  • Table of contents block
    • Other settings: Heading, Heading levels.

Fixed blocks (always part of the section; select them in the sidebar to change them)

  • Sidebar block
    • Recent articles block
      • Other settings: Number to show, Show images, Blog.
    • Tags block
      • Other settings: Number to show.
    • Products block
      • Other settings: Heading, Products.
    • Search block
      • Other settings: Search articles only.
    • Image (shared block, see Shared blocks)
    • Text (shared block, see Shared blocks)
    • Email signup (shared block, see Shared blocks)
    • Social media links (shared block, see Shared blocks)
    • App blocks from apps you install
    • Issue box block
      • Other settings: Text above heading, Product, Issue number, Heading, Text, Button label, Show more settings, Front cover, Second cover, Third cover, Link.
    • Also takes these blocks, described above: Table of contents.

404 page

The page shown when a link is broken, with search and ways back.

Other settings: Show search, Image, Content alignment.

Also has the standard section settings.

Blocks you can add

Password

The page shown while the store is password protected.

Sizes and layout

  • Overlay opacity †: 0 to 80 %, in steps of 5 (default 30).

Other settings: Media type, Image, Content alignment.

Also has the standard section settings.

Blocks you can add

  • Text (shared block, see Shared blocks)
  • App blocks from apps you install

Gift card

The page a buyer or recipient opens from the gift card email.

Other settings: Card image, Card color scheme, Show message field, Show print button, Help text.

Also has the standard section settings.