Shopify theme documentation
Kangri
Customization Guide
A practical reference for configuring Altiora’s navigation, product experiences, collection layouts, storytelling sections, and interactive shopping features.
General
Kangri is a sophisticated Shopify theme crafted for brands that value elegant design and immersive shopping experiences. This guide covers install, every theme setting, block, section, and page type, and ongoing updates. Keep it bookmarked as a reference.
Before any change, such as installing an app, editing settings, or updating the theme, duplicate your theme first:
- Go to Online Store > Themes in your Shopify admin.
- Find your current theme and click the ... menu.
- Select Duplicate.
- Make your changes on the duplicate, preview them, and only then publish.
Installation & Setup
1. Download the theme package
After purchasing, download the theme .zip file from your order confirmation or account dashboard. Do not unzip the outer folder. Shopify needs the .zip file as it is.
2. Upload to Shopify
- In your Shopify admin, go to Online Store > Themes.
- Click Add theme > Upload zip file.
- Select the Kangri.zip file and click Upload file.
- Click Customize to open the theme editor.
3. (Optional) Import demo content
To match one of our demo presets, use the one-click demo importer in the theme editor's settings panel. Replace the sample content with your own afterward.
4. Publish when ready
Preview your store, then go to Online Store > Themes and click Publish.

App Integrations
Kangri is compatible with most popular Shopify apps. Apps that add visible elements, such as badges, popups, and chat widgets, usually install through Shopify's app embed system.
Enabling app embeds
- Open Theme Editor > App embeds (puzzle-piece icon in the left sidebar).
- Toggle on the app embeds you have installed.
- Save, then preview your storefront to confirm the app displays.
- Reviews: Judge.me, Loox, Yotpo, and similar apps embed on product pages.
- Upsells & cross-sells: compatible with cart drawer and post-purchase apps.
- Search & filtering: works with Shopify Search & Discovery and most third-party apps.
- Page builders: compatible with PageFly and GemPages for landing pages.
Kangri is built on Online Store 2.0, so apps made for older theme structures may need an updated version.
Customization
Almost every part of Kangri can be customized from the theme editor (Online Store > Themes > Customize) without code. Choose a topic below to jump to its guide.
- 1Theme SettingsColors, fonts, layout, cart and more
- 2Theme BlocksText, buttons, headings and other blocks
- 3Main SectionsSections you can add to any page
- 4Product PagePre-order, size chart, badges and more
- 5Collection PageBanners, sub collections and filters
- 6CartCart setup and free shipping bar
- 7SearchSearch suggestions and results page
- 8Other PagesPages, gift cards and blog
- 9Header, Mega Menu & FooterNavigation, mega menu and footer
Theme Settings
Store-wide defaults, found under the Theme settings gear icon in the theme editor. Changes here apply to every page.
| Setting | What it does |
|---|---|
| Color | Brand, text, button, and background colors, including color schemes you can assign per section. |
| Typography | Heading and body fonts, base font size, and letter spacing. |
| Logo & Favicon | Controls the storefront logo and the favicon displayed for the Kangri store. |
| Page layout | Controls the overall page layout and spacing used by the theme. |
| Product Card | How cards look in grids: image ratio, hover image, price, badges, swatches, and quick view. |
| Cart | Cart drawer or cart page, order note, and free shipping bar defaults. |
| Theme style | Overall look: button style, input style, and shadows. |
| Custom CSS | Add your own CSS for the whole store. Keep it short and test on mobile. |
| Badges | Controls the appearance and presentation of product badges displayed on the storefront. |
| Animations | Turn scroll and hover animations on or off, and set their speed. |
| Input Fields | Controls the appearance of form and input fields used throughout the storefront. |

Theme Blocks
Reusable blocks you can add inside most sections using Add block. Drag blocks in the left panel to reorder them.
| Component | Items / Components |
|---|---|
| Header | Provides the storefront header and its associated navigation and controls. |
| Media | Displays the product media within the search-result product card. |
| Product title | Displays the title of the selected product within the relevant product component. |
| Price | Displays the product price within the relevant product or product-card component. |
| Title | Displays the title text for the relevant section or content component. |
| Description | Displays descriptive text for the relevant section, product, or content component. |
| Image | Displays an image associated with the relevant section, collection, or content component. |
| Button | Provides a clickable button for the relevant action or destination. |

Main Sections
Sections you can add to any page with Add section. Click a section to open its settings, and use the eye icon to hide it without deleting it.
| Section | Components / Items |
|---|---|
| Hero | Provides the main hero area used to introduce the storefront with prominent visual content. |
| Custom Slideshow | Provides a custom slideshow for presenting multiple visual slides within the storefront. |
| Featured collection | Displays selected products from a collection in a featured product layout. |
| Custom Featured collection tabs | Displays featured products through tabbed collection content. |
| Custom Promotional Banner | Displays promotional content in a dedicated banner section. |
| Custom Collection Slider | Displays collection content in a horizontally arranged slider. |
| Custom Collection List | Displays selected collections together in a collection-list layout. |
| Hyper Collection Tab | Provides tabbed collection content for switching between collection displays. |
| Kangri Product grid with Banner | Combines a product grid with a promotional or visual banner. |
| Custom Background product | Provides a product-focused section that uses a custom background presentation. |
| Collection title slider with icon | Displays collection titles in a slider together with supporting icons. |
| Custom Banner Slider with Product | Combines banner slides with product-focused content. |
| Two Column Cards | Displays content in two side-by-side cards. |
| Image with Scrolling tag content | Combines an image with scrolling tag-style content. |
| Custom Section | Provides a flexible custom section for additional storefront content. |
| Blog posts: Grid | Displays blog posts in a grid layout. |
| Kangri Reviews Slider | Displays review content in a slider layout. |

Product Page
Settings and features for product pages. Most are in the Product template of the theme editor, and some are set on the product in Shopify admin.
| Section / Component | Items / Components |
|---|---|
| Header | Provides the storefront header and its associated navigation and controls. |
| Product information | Provides the main product information area containing the product media and product details. |
| Details | Contains the main product detail components shown alongside the product media. |
| Recommended products | Displays products recommended alongside or below the main product content. |

Collection Page
Settings for collection pages and the collection list page.
| Section / Component | Items / Components |
|---|---|
| Header | Provides the storefront header and its associated navigation and controls. |
| Collection heading | Provides the heading area for the current collection. |
| Collection | Provides the main collection product area and its collection browsing controls. |
| Product card |
Product image: Displays the primary image associated with a product in the collection grid. Product title: Displays the title of the selected product within the relevant product component. Price: Displays the product price within the relevant product or product-card component. |

Cart
Settings for the cart drawer or cart page.
| Section / Component | Items / Components |
|---|---|
| Header | Provides the storefront header and its associated navigation and controls. |
| Cart | Controls the theme's cart-related presentation and available cart styling options. |
| Featured collection | Displays selected products from a collection in a featured product layout. |

Search
Settings for how shoppers find products.
| Section / Component | Items / Components |
|---|---|
| Header | Provides the storefront header and its associated navigation and controls. |
| Search | Provides the main search section containing the search heading and search input. |
| Search results | Displays the products returned for the current search query. |
| Product card |
Media: Displays the product media within the search-result product card. Product title: Displays the title of the selected product within the relevant product component. Price: Displays the product price within the relevant product or product-card component. |

Other Pages
Settings for pages outside the shopping flow.
| Section / Component | Items / Components |
|---|---|
| Header | Provides the storefront header and its associated navigation and controls. |
| Page | Provides the page-level content area for the assigned page template. |
| Contact form | Provides the form through which visitors can submit contact information and messages. |

Header, Mega Menu & Footer
Header & Announcement Bar
Click Header in the left panel to set the logo size, choose the menu, switch between centered and left-aligned layouts, and show or hide the search, account, and cart icons. Click Announcement bar to add rotating messages, a countdown, or a dismiss option.
Mega Menu
Step 1: Build the menu in Shopify
Go to Content > Menus > Main menu. Add top-level items (for example "Shop") and nest submenu items under them.
Step 2: Add the Mega Menu block
In the theme editor, go to Header > Menu, select your menu, click Add block, and choose a Mega Menu type.
Step 3: Match the menu item label
The Menu item label must match the Shopify menu item name exactly. If your item is "Shop", the label must read "Shop".
Step 4: Choose a type
- Shop: for stores with many collections. Shows featured collections, a product showcase, and the menu.
- Card: up to 4 image cards, each with a title, button, and link.
- Promo image: up to 2 banner images with heading, text, and button.

Footer
Scroll to the bottom of the left panel to edit the footer. You can set the number of columns, the menu in each column, newsletter signup placement, and payment icon and social link visibility.
Product Setup
Kangri is tuned for specific image ratios and variant structures. Setting products up correctly avoids layout shifts and uneven cards.
| Image type | Recommended ratio | Minimum size |
|---|---|---|
| Product card / grid image | 3:4 (portrait) | 800 × 1067px |
| Product page main image | 1:1 or 4:5 | 1200 × 1200px |
| Collection banner | 16:9 or 21:9 | 1600 × 700px |
Mixing ratios in one collection crops cards inconsistently, so keep one ratio per collection.
Variant swatches
For color swatches instead of a dropdown, name the option exactly Color (or your equivalent set in theme settings) and use standard names such as "Black", "Navy", or "Forest Green".
Collections
Organize collections by category rather than by promotion. Your navigation stays stable when a sale ends.

Troubleshooting
Theme looks broken after a change: Clear your browser cache and test in a private window. Most cases are stale cached CSS.
Edits are not saving: Confirm you are editing the right theme and clicked Save before closing the editor.
Mobile looks different from desktop: Many sections have separate mobile settings. Check the section panel first.
An app is not displaying: See App Integrations. It is usually an app embed left off.
Mega Menu is missing: Check that the Menu item label matches your Shopify menu item exactly (see Header, Mega Menu & Footer).
Images look cropped oddly: Check the ratios in Product Setup.
Still stuck? Contact support with a screenshot, the exact page URL, and your browser and device.
Version
Current version: 1.0.0
Shopify compatibility: Online Store 2.0
Last updated:
To check your installed version, open the theme editor and look under Theme settings > About this theme.
Changelog
| Version | Date | Changes |
|---|---|---|