Apps
Kyoto works with apps through Shopify's own two ways of adding them: app blocks and app embeds. Neither needs code in the theme, so removing an app never leaves code behind (as long as nobody edited the theme's files for it).
App blocks and app embeds
- App blocks sit inside a section, where you put them. Select the section in the theme editor, choose Add block > Apps and pick the app. Kyoto passes the section's page width, spacing and color scheme to the app block. How the app looks inside its block is up to the app.
- App embeds run on every page, for example a chat button or a tracking script. Turn them on or off under App embeds in the theme editor's left sidebar.
When an app offers both, prefer the app block: it loads only on the pages where you place it (see Performance tips).
Sections that accept app blocks
| Where | Sections |
|---|---|
| Any page | Apps (a frame that holds one app on its own), Custom section, Hero, Featured collection, Featured product, Newsletter, Ranking, Recently viewed, Testimonials, Reviews |
| Product page | Product information, Product details, Product recommendations, Complementary products |
| Collection, search and list pages | Product grid, Search results, Collections list |
| Cart | Cart (the page), Cart drawer |
| Blog and pages | Blog, Article, Page |
| Header, footer and pop-ups | Announcement bar, Footer, Launcher; the header has its own Apps block |
| Other | 404 page, Password |
Common apps and where they go
| App | In Kyoto |
|---|---|
| Product reviews | Add the Reviews section under the product information and put the app's block in it. Ratings that the app saves in Shopify's standard review metafields also show as stars on product cards (Show rating in Theme settings > Product cards) and in the Rating block. |
| Filters | Kyoto uses Shopify's own storefront filters. Choose them in the Shopify Search & Discovery app (see Collection page). |
| Complementary products | Set them in Shopify Search & Discovery; Kyoto shows them in the Complementary products block and section. |
| Subscriptions and pre-orders | The Purchase options block shows the plans of a subscription or pre-order app on the product page. |
| Translation | Translate & Adapt or another translation app translates your content; Kyoto's own words are already translated (see Languages). |
| Social feeds | Place the feed app's block in the Apps section or another section that accepts apps. |
If an app's instructions ask you to paste code into the theme, ask the app developer for an app block instead. Code pasted into theme files is not carried over when you update Kyoto.