Shopify theme documentation

Alpine
Customization Guide

A practical reference for configuring Altiora’s navigation, product experiences, collection layouts, storytelling sections, and interactive shopping features.

10 customization guides Responsive documentation Theme editor reference

General

Alpine is a modern Shopify theme built to deliver a clean, elegant, and engaging shopping experience. 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:

  1. Go to Online Store > Themes in your Shopify admin.
  2. Find your current theme and click the ... menu.
  3. Select Duplicate.
  4. Make your changes on the duplicate, preview them, and only then publish.
Requirements: Alpine works on any Shopify plan and supports all modern browsers (Chrome, Firefox, Safari, Edge). Keep your browser updated for the best theme editor experience.

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

  1. In your Shopify admin, go to Online Store > Themes.
  2. Click Add theme > Upload zip file.
  3. Select the Alpine.zip file and click Upload file.
  4. 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.

Publish Theme

App Integrations

Alpine 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

  1. Open Theme Editor > App embeds (puzzle-piece icon in the left sidebar).
  2. Toggle on the app embeds you have installed.
  3. Save, then preview your storefront to confirm the app displays.
If an installed app does not show, check this first. Most cases are an embed left off, not a compatibility problem.
  • 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.

Alpine is built on Online Store 2.0, so apps made for older theme structures may need an updated version.

App Embeds

Customization

Almost every part of Alpine can be customized from the theme editor (Online Store > Themes > Customize) without code. Choose a topic below to jump to its guide.

  1. 1Theme SettingsColors, fonts, layout, cart and more
  2. 2Theme BlocksText, buttons, headings and other blocks
  3. 3Main SectionsSections you can add to any page
  4. 4Product PagePre-order, size chart, badges and more
  5. 5Collection PageBanners, sub collections and filters
  6. 6CartCart setup and free shipping bar
  7. 7SearchSearch suggestions and results page
  8. 8Other PagesPages, gift cards and blog
  9. 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 Alpine 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 Settings

Back to Customization

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.
Theme Blocks

Back to Customization

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.
Alpine Product grid with Banner Combines a product grid with a promotional or visual banner.
Custom Background product with … 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.
Alpine Reviews Slider Displays review content in a slider layout.
Main Section

Back to Customization

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.
Product Page

Back to Customization

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.
Collection Page

Back to Customization

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.
Cart

Back to Customization

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.
Search

Back to Customization

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.
Other Pages

Back to Customization

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".

Mega Menu will not display if the label does not match exactly. This is the most common setup mistake.

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.
Mega Menu Settings

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.

Back to Customization

Product Setup

Alpine 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.

Collections

Theme Update

Updating replaces the theme's code, so direct code edits must be reapplied by hand unless you have documented them.

Before updating

  1. Duplicate your live theme as a backup (see General).
  2. Note any custom code changes, including anything in Custom CSS.

Updating steps

  1. Download the latest .zip from your account dashboard.
  2. In Online Store > Themes, click Add theme > Upload zip file. This does not overwrite your live theme.
  3. Reapply your settings and custom sections in the new theme's editor.
  4. Preview thoroughly, then publish.
Theme settings generally do not carry over when uploaded as a new theme. Budget time to reconfigure before publishing.
Theme Update

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