Getting started
Install the theme
- In your Shopify admin, go to Online Store > Themes.
- Find Athlex in the Shopify Theme Store and click Try theme or Add theme.
- The theme is added to your theme library. Click Customize to start editing.
- When you are ready, click Publish.
Recommended setup order
- Upload your logo and choose your colors and fonts (Theme settings).
- Create your menus in Online Store > Navigation and assign them in the Header and Footer.
- Build your home page with the sections described below.
- Pick a product page layout and add the product blocks you need.
- Set up collection pages, the cart and your contact page.
Theme settings
Open the theme editor and click the Theme settings (gear) icon.
Logo and favicon
| Setting | Description |
|---|---|
| Logo | Upload an SVG or PNG. If empty, your store name is shown as text. |
| Logo width | Controls the logo width in the header. |
| Favicon | Square image, scaled to 32 × 32 px. |
Colors
| Setting | Description |
|---|---|
| Accent color | Main highlight color used for buttons, badges and highlights. |
| Text on accent color | Text color on top of the accent color. Keep the contrast high. |
| Accent color 2 | Secondary highlight color. |
| Text on accent color 2 | Text color on top of the second accent color. |
| Theme bar color | Browser toolbar color on mobile devices. |
| Color schemes | Background, text and button colors. Each section can use any color scheme. |
Typography
Athlex uses fonts from the Shopify font library, so there is nothing extra to install.
| Setting | Used for |
|---|---|
| Headings | Page and section headings and prices. |
| Navigation, buttons and labels | Uppercase menus, buttons, badges and small labels. Choose a font that has bold weights. |
| Body | Paragraphs and form fields. |
Layout
- Page width: maximum width of the content area.
- Animations enabled: turns scroll reveal and motion effects on or off. Motion is always reduced for visitors who have "reduce motion" enabled on their device.
Product cards
- Show vendor: shows the vendor name on product cards.
- Show quick add: adds a quick add to cart button on product cards.
Cart
- Cart type: Drawer (slides in from the side) or Page (opens the cart page).
- Free shipping threshold: shows a free shipping progress bar in the cart. Enter the amount in your store currency. Set to 0 to hide it. The bar is hidden automatically when a customer shops in a different currency.
Social media
Add links to Instagram, Facebook, TikTok, YouTube, X (Twitter) and Pinterest. The icons appear in the footer.
Header and footer
Header
| Setting | Description |
|---|---|
| Menu | Main navigation menu. Supports dropdowns. |
| Customer account menu | Menu shown in the account popup (for example Orders and Profile). |
| Mega collection | A collection that is featured inside the mega menu. |
| Show search | Shows the search icon and full-screen predictive search. |
| Phone, Email, Address | Contact details shown in the mobile menu. |
Badge blocks add a small label (for example "New" or "Sale") next to a menu item. Enter the exact menu link title, a label and a color.
Customer accounts: the account icon uses Shopify's customer account component. Turn on customer accounts in Settings > Customer accounts.
Footer
The footer supports these blocks:
- Brand: logo, short text and social icons.
- Menu: a list of links from a menu.
- Contact: contact details.
The large outlined store name at the bottom of the footer uses your store name automatically.
Home page sections
Click Add section in the theme editor to add any of these sections. You can reorder and hide sections at any time.
| Section | What it does |
|---|---|
| Hero | Full-width banner with a video or image, heading, accent heading, lead text, two buttons and an optional ticker. If you add a video, also add an image: it shows while the video loads, and is used when visitors have reduced motion or data saver turned on. A pause button is added automatically for accessibility. |
| Slideshow | Image slides with separate desktop and mobile images, text and two buttons per slide. Supports auto-rotate and a ticker. Uses the image focal point. You can override it with Image position override (for example 30% 50%). |
| Statement | A large typographic statement mixed with images and product images. Build it with Text, Image, Product and Break blocks. Text blocks can be normal, underlined or accent. Set Layout to Hero when it is the first section on the page. |
| Trust bar | A row of short benefits (for example free shipping and secure checkout). |
| Collection tiles | Large tiles linking to collections. |
| Collection rows | A numbered list of collections, each with product thumbnails and a product count. |
| Featured collection | A product grid from one collection, with optional filter chips. |
| Featured product | Shows one product with the same blocks as the product page, so customers can buy right from the home page. |
| Product finder | Helps customers pick products by goal. Each Goal block links to a product or tag and can show chips. |
| Brand values | Short value statements with icons. |
| How to use | Numbered steps. |
| Testimonials | Customer reviews. |
| Blog posts | Latest articles from a blog. |
| FAQ | Collapsible questions and answers. |
| Newsletter | Email sign-up form. Optional background video. Subscribers appear in Customers with email marketing consent. |
| Product recommendations | Products related to the current product. |
| Contact form | A contact form you can place on any page. |
| Custom Liquid | Add your own Liquid, HTML or app code. |
Using images and videos
- Upload videos in the section's Video setting. Shopify hosts and optimizes them for you.
- Set the focal point of an image in Content > Files or from the image picker. Athlex keeps that point visible on every screen size.
- Recommended sizes: hero and slideshow images 2000 px wide (mobile slides 1080 × 1920 px), collection tiles 1200 px, statement images 600 px.
Product pages
Layouts
Choose a layout in the Product information section:
| Layout | Best for |
|---|---|
| Default | Most products. Gallery and details side by side. |
| Stacked gallery | Products with many images. All media is stacked and the details stay sticky. |
| Showcase | Hero products. A colored stage behind the image and a large title. |
Athlex includes the templates product, product.stacked, product.showcase and product.gift-card. To use one, go to the product in your admin and pick a Theme template.
Product blocks
Add, remove and reorder these blocks:
- Vendor and type
- Title
- Price: shows sale and unit prices, and taxes or shipping notes.
- Highlights: short key facts (for example "25 g | Protein"). See Metafields.
- Description
- Text
- Variant picker: buttons, dropdowns or swatches. Color and flavor options show as swatches when swatch data is set in the product's option values.
- Quantity selector
- Buy buttons: add to cart and dynamic checkout buttons. Gift card products show a recipient form automatically.
- Trust badges
- Pickup availability: shows local pickup availability when it is turned on in your store.
- Collapsible tab: for ingredients, nutrition facts, shipping and returns, and similar details.
- Share
- Custom Liquid
- Apps: app blocks from installed apps, such as reviews or subscriptions.
Other product features
- Sticky add to cart bar: turn it on with Show sticky add to cart bar.
- Media: images, videos, external videos and 3D models (with AR on supported devices).
- Gallery background: set Gallery background, or use the
custom.stage_colormetafield to set it per product.
Gift cards
Use the product.gift-card template for gift card products. Customers can send the gift card to someone else with a name, a message and a delivery date. The gift card email page uses the theme's colors and shows a QR code.
Collection pages
Layouts
| Layout | Description |
|---|---|
| Default | Dark header band with the title, description and optional ticker. |
| Banner | Image header and a filter drawer. |
| Split | Sticky side column with the title and filters. |
The templates collection, collection.banner and collection.split are included.
Filters and sorting
Turn on Enable filtering and Enable sorting. Manage the filters in the Search & Discovery app from Shopify.
Promo tile
Add a Promo tile block to show a banner inside the product grid. Choose the position with Show after product.
Cart
- Cart drawer: opens when a product is added. Customers can change quantities, see the free shipping bar and check out.
- Cart page: full cart with order notes. Add Empty cart tile blocks to suggest collections when the cart is empty.
Other pages
| Page | Notes |
|---|---|
| Search | Predictive search shows products, collections, pages and articles while typing. |
| Blog and article | Featured article and article list. Articles show the author, date and share links, and comments when they are turned on for the blog. |
Contact (page.contact) | Contact form plus Contact card blocks for phone, email and address. Messages go to your store's sender email. |
| Collections list | All collections in a grid. |
| 404 | A custom "page not found" page with a search box and links. |
| Password | Shown while your store is password protected. Includes a newsletter form. |
| Customer accounts | Login, register, account, orders and addresses are styled to match the theme. If you use the new customer accounts, Shopify hosts these pages. |
Metafields
Athlex can show extra product information from metafields. Create them in Settings > Custom data > Products.
| Namespace and key | Type | Used for |
|---|---|---|
custom.highlights | Multi-line text | Product highlights. One item per line in the format value | label, for example 25 g | Protein. If empty, the Highlights block shows its own default items. |
custom.subtitle | Single line text | Subtitle on product cards. If empty, the product type is shown. |
custom.stage_color | Color | Gallery background color for this product. |
reviews.rating | Rating | Star rating on product cards. Most review apps fill this in automatically. |
Apps and custom code
- App blocks: most apps add blocks you can place in the product page, in the Featured product section or in App embeds (Theme settings > App embeds).
- Custom Liquid: add your own code with the Custom Liquid section or the Custom Liquid product block. Code in these settings stays in place when you update the theme.
Performance and accessibility
- Images are responsive and lazy loaded. The first image on the page loads with high priority.
- Videos start after the page has loaded and are not loaded when data saver or reduced motion is turned on.
- Fonts come from the Shopify font CDN.
- All interactive elements work with a keyboard and have visible focus states. Animations respect the "reduce motion" setting.
Tips for a fast store:
- Upload images no larger than needed (2000 px wide is enough for full-width images).
- Keep hero videos short (10–20 seconds) and under 5 MB.
- Remove apps you no longer use.
Updating the theme
When a new version is released, Shopify shows an update notice in Online Store > Themes.
- Click View update on the theme card.
- Shopify adds the updated theme to your library and keeps your settings and content.
- Preview it, then publish.
Changes made directly to code files are not carried over.
FAQ and troubleshooting
My logo does not show; the store name appears instead.
Upload a logo in Theme settings > Logo and favicon.
The hero video does not play.
Check that the visitor does not have reduced motion or data saver turned on. In those cases the image is shown instead, by design. Make sure an image is also set.
The free shipping bar does not appear.
Set a threshold above 0 in Theme settings > Cart. The bar only shows in your store's default currency.
Swatches do not appear.
Add swatch colors or images to the option values in the product admin (for example the Color or Flavor option).
The account menu shows an error.
Create the menu set as Customer account menu in Online Store > Navigation, or choose another menu in the Header settings.
Filters do not show.
Install the Search & Discovery app and add filters there. Then turn on Enable filtering in the collection section.
Still need help? Contact support.
Changelog
1.0.0
- Initial release.