Welcome to the Kagami's documentation!

This documentation is organized in several sections. It will help you to take full advantage of this theme.

Remember, though : the best way to customize your theme is to experiment by playing with the various settings. Don't worry, you won't break anything! If you want to revert to the original theme settings, it's really easy. Just follow those steps:

  1. Open the your Theme Settings.
  2. On the left, open the drop down for the "Theme presets" section. It should say "Custom".
  3. You can see all the theme's original presets ("Baptiste", "Kyoto"...). Select the one you prefer.
  4. Click save: you're done, your theme settings have been reseted to its original state!

Table of Content


Global settings

Mobile and tablet

Home page

List of collections page

Collection page

Product page

Custom page

Blog page


This document keeps track of all new versions of Kagami. You can know your theme's version by clicking into the small "Info" link at the top right of the Theme Settings.

If you ever need to upgrade the theme, you'll need to go through the upgrde process, as described in this page. We only recommend you to upgrade the theme if a new version fixes a bug you have, or if you need a new feature introduced by a new version.

Alternatively, for bug fixes, you can also contact us directly and we'd be happy to backport one or two small fixes.

  • 3.6.3: Fixed an issue on iOS 10, where selecting a quantity or a dropdown would zoom in the screen, but not zoom out when unselected.
  • 3.6.2: Fixed an important bug due to the release of iOS10, where the "Edit cart" button may not be visible in the mini-cart. We will send shortly an email to all customers with a way to resolve yourself the issue, but if you're encountering it, feel free to send us a mail to shopify-support@maestrooo.com
  • 3.6.1: Direct checkout button on mini-cart has been removed as it caused some subtle issues if the customer goes back from the checkout to your website. Also, forcing the customer to go to the cart page allows to display additional payment methods, such as Apple Pay.
  • 3.6.0: Twitter recently removed the "widget ID" that we used to pull latest tweet. This version includes new code to use the new recommended method. Now, you will no longer need to create a widget: entering your Twitter username will be enough.
  • 3.5.8: Fixed an issue where the Google Map on contact page may not work correctly on new shops.
  • 3.5.7: Fixed a bug where the "price" in rich snippet could be invalid if you were using a non-american formatting for numbers.
  • 3.5.6: Added a new setting that allow to prevents the theme to switch to the variant image when the product is accessed from a collection page (so without any selected variant).
  • 3.5.5: Fixed a bug where auto-completion search could not working in some circumstances.
  • 3.5.4: Added a new setting that allows to control the position of Add to cart button on product pages (either before or after description).
  • 3.5.3: Fixed a bug where the cart note was not properly displayed if customer was going back from the checkout.
  • 3.5.2: If you are using the mega-nav feature with the "sub-collections pages", the theme will now be able to extract the image of the first collection to display it on hover if you have also activated the "show switch image on hover" setting.
  • 3.5.1: Fixed a bug where search bar was incorrectly displayed on some browsers. This issue was introduced in 3.5.0 when trying to fix a temporary issue in Chrome v50. If you're encountering this issue please contact us!
  • 3.5.0: Rewrite the cart so that it is easier to remove CartJS (which power our dynamic cart) for app developer that want to integrate their app within our theme but have trouble with CartJS.
  • 3.4.0: Added a new feature to display thumbnails on product page.
  • 3.3.3: Fixed a bug where store logo was not properly used as the Facebook image for home page.
  • 3.3.2: Alt tags are now properly escaped. Previously, if your alt tags contained special characters such as quotes ("), the alt tag was incorrectly set.
  • 3.3.1: Fix a bug where Twitter feed stopped working (it was due to a change in Twitter API). If you're affected by this, contact us and we'll be happy to fix it in your theme!
  • 3.3.0: Built-in currency conversion is now available in the theme. You don't need to pay for an app anymore!
  • 3.2.2: Due to popular request, we've re-added back an option that allows to control how many products per row are displayed on mobile (1 or 2).
  • 3.2.1: Fixed a bug that prevented the new Shopify SSL feature to work on themes that had a Google map activated in their "contact us" page.
  • 3.2.0: Instagram integration has been re-added as Shopify team has been able to find a solution!
  • 3.1.0: Instagram integration has been removed from the theme due to new Instagram rules. Learn more by clicking here.
  • 3.0.1: Chrome 48 introduced a bug where images were sometimes distorted. Until this bug is fixed directly in Chrome, this new release introduces a temporary fix.
  • 3.0.0: A new, beautiful dark preset has been added to the theme. Discover it by clicking here.
  • 2.4.1: Fixed a bug where images were duplicated if no text was specified in the new page.slider template.
  • 2.4.0: A new template was added: page.slider. This specific template allows you to easily embed a slideshow of images inside any pages, without any coding knowledge (learn more about it here).
  • 2.3.0: Two alternate templates were added: page.wide and article.template. Those templates, that can be set for a page or a blog article (respectively), allow to display content in a wider container.
  • 2.2.8: Fixed a bug where product image was not always visible if you had only one image.
  • 2.2.7: Fixed a bug on mobile that prevents all sidebar items to be visible when using the top bar.
  • 2.2.6: Fixed a bug when using the mega-nav after opening other dropdown in the nav could prevent some links to be clickable.
  • 2.2.5: Fixed a bug where auto-complete search would return pages and articles even if the option to only return products was enabled.
  • 2.2.4: Added a new font (Courier New) for all typography settings / slightly reduced the size of image for horizontal navigation on desktop to improve readability / fixed a bug where some color choices could lead to unreadable label for mini-cart.
  • 2.2.3: Made some improvements to the Masonry, so that clicking on a tile while not all images have loaded yet properly redirects to the correct product.
  • 2.2.2: Fixed a bug where quantity box on product pages did not display correctly on latest Microsoft Edge browser.
  • 2.2.1: Sharing on Twitter (either for product or article) now add the product or title name before the URL.
  • 2.2.0: Theme settings to specify featured collections on home page were simplified: you no longer need to create a linklist, instead you can visually specify your collections / If only Instagram module is enabled (without Twitter), it will now load 6 images rather than 3 ; if Twitter is enabled, it will still load 3 Instagram pictures as before.
  • 2.1.1: Fixed a bug in the horizontal navigation where the background color of dropdown were not correctly applied.
  • 2.1.0: Fixed an issue that made scroll complicated on latest iOS versions of Chrome / updated the theme settings to make them compliant with latest Shopify rules (some settings were removed, some other were simplified, so that the overall experience for merchants is easier).
  • 2.0.0: Thanks to all your suggestions, we're happy to announce the v2 of Kagami theme. The most important addition is a new, optional horizontal navigation, as well as a "mega-nav" that brings the theme to a whole new level. Also : added compatibility with Apple Pay for gift card / added compatibility for the newly introduced blog article feature image / added the Dankort credit card logo. 
  • 1.5.0: Added a new option that allows to display the informational top bar on mobile.
  • 1.4.5: Fixed a rare bug where dropdown in the sidebar menu did not work.
  • 1.4.4: Fixed an issue when sharing a blog article used to always share the homepage instead of the actual article.
  • 1.4.3: Fixed an issue when using characters like ' or / for "Add to cart" button.
  • 1.4.2: Slightly improve the cart page layout when using both PayPal and Google Wallet as additional checkouts methods.
  • 1.4.1: Fixed an issue where "Login" link was displayed on mobile, even if customer accounts were disabled.
  • 1.4.0: Added a new option to enable auto-completion side wide (so that blog articles and pages are also returned) in addition of the current "products only" search.
  • 1.3.0: Added a new way to display collections, so you can now, as for products, decide to display them either using the masonry or a standard grid (more info) / improved the "title" meta tag for SEO, by displaying the current tags (if any)." tag for SEO by displaying the tags, if any.
  • 1.2.3: Added an optimization to load appropriate images based on context, when using the collection grid layout. When using modern OS like iOS 9, mobile users will in average download 15% less image data than before when browsing a collection page / added an optimization on desktop when using the grid, so that smaller images are used when using a 4, 5 or 6 images per row setting, hence also resulting in approximately 15% less data being sent.
  • 1.2.2: Added an optimization for Chrome and Safari browsers on product pages so that less images are loaded when related products is enabled.
  • 1.2.1: Added a few data in HTML for even better Google indexing.
  • 1.2.0: Added a new feature that allows to create pages that contains list of collections, using Masonry (more info).
  • 1.1.2: Fixed a bug where Visa logo was not displayed in footer / add a "decline" button in the "Activate account" template / added support for custom properties on product pages (the properties are now automatically displayed in the cart).
  • 1.1.1: Fixed a bug when sharing a product with Pinterest
  • 1.1.0: Removed the "crop factor" setting from the "list of collections page" section, and replaced it by a new, simpler setting called "align images at bottom". This allows to force collection images to be aligned at bottom, at the expense of a potentially strong crop.
  • 1.0.4: Added a Slovakian translation (thanks to our customer Marek from Kulau Coconut !)
  • 1.0.3: Added a new option in slider theme settings that allows to remove the gradient that is automatically added over images to increase contrast. 
  • 1.0.2: Fixed an incompatibility issue with currency conversion apps. Kagami is now fully functional with Auto Currency Switcher app, that we recommend / fixed an issue with newsletter module not displaying correctly if button background was a very dark color / added a new setting to modify the size of page title.
  • 1.0.1: Presets have been renamed due to conflicts in the Theme Store. Tokyo is now called Kyoto, and Paris is now called Baptiste.
  • 1.0.0: Initial release

Still have question?

You have found a bug? This documentation was not clear enough? You can contact us at shopify-support@maestrooo.com. We do our best to answer all support requests within 24 hours (during working days). We work from 9am to 5pm, UTC +1, and are able to help you both in English and French. If you do not receive a response from us within 24 hours, please do not send a follow-up email, as this will bump you to the end of our support queue.