AthlexShopify Online Store 2.0

Athlex · Documentation

Athlex Theme Documentation

Athlex is a Shopify Online Store 2.0 theme by sadecode, made for sports nutrition, supplement, fitness and active lifestyle brands. This guide explains how to install, set up and customize the theme.

  • Version1.0.0
  • PlatformShopify Online Store 2.0
  • Sections14 topics

Getting started

Install the theme

  1. In your Shopify admin, go to Online Store > Themes.
  2. Find Athlex in the Shopify Theme Store and click Try theme or Add theme.
  3. The theme is added to your theme library. Click Customize to start editing.
  4. When you are ready, click Publish.
  1. Upload your logo and choose your colors and fonts (Theme settings).
  2. Create your menus in Online Store > Navigation and assign them in the Header and Footer.
  3. Build your home page with the sections described below.
  4. Pick a product page layout and add the product blocks you need.
  5. 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

SettingDescription
LogoUpload an SVG or PNG. If empty, your store name is shown as text.
Logo widthControls the logo width in the header.
FaviconSquare image, scaled to 32 × 32 px.

Colors

SettingDescription
Accent colorMain highlight color used for buttons, badges and highlights.
Text on accent colorText color on top of the accent color. Keep the contrast high.
Accent color 2Secondary highlight color.
Text on accent color 2Text color on top of the second accent color.
Theme bar colorBrowser toolbar color on mobile devices.
Color schemesBackground, 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.

SettingUsed for
HeadingsPage and section headings and prices.
Navigation, buttons and labelsUppercase menus, buttons, badges and small labels. Choose a font that has bold weights.
BodyParagraphs 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.

SettingDescription
MenuMain navigation menu. Supports dropdowns.
Customer account menuMenu shown in the account popup (for example Orders and Profile).
Mega collectionA collection that is featured inside the mega menu.
Show searchShows the search icon and full-screen predictive search.
Phone, Email, AddressContact 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.

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.

SectionWhat it does
HeroFull-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.
SlideshowImage 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%).
StatementA 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 barA row of short benefits (for example free shipping and secure checkout).
Collection tilesLarge tiles linking to collections.
Collection rowsA numbered list of collections, each with product thumbnails and a product count.
Featured collectionA product grid from one collection, with optional filter chips.
Featured productShows one product with the same blocks as the product page, so customers can buy right from the home page.
Product finderHelps customers pick products by goal. Each Goal block links to a product or tag and can show chips.
Brand valuesShort value statements with icons.
How to useNumbered steps.
TestimonialsCustomer reviews.
Blog postsLatest articles from a blog.
FAQCollapsible questions and answers.
NewsletterEmail sign-up form. Optional background video. Subscribers appear in Customers with email marketing consent.
Product recommendationsProducts related to the current product.
Contact formA contact form you can place on any page.
Custom LiquidAdd 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:

LayoutBest for
DefaultMost products. Gallery and details side by side.
Stacked galleryProducts with many images. All media is stacked and the details stay sticky.
ShowcaseHero 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_color metafield 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

LayoutDescription
DefaultDark header band with the title, description and optional ticker.
BannerImage header and a filter drawer.
SplitSticky 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

PageNotes
SearchPredictive search shows products, collections, pages and articles while typing.
Blog and articleFeatured 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 listAll collections in a grid.
404A custom "page not found" page with a search box and links.
PasswordShown while your store is password protected. Includes a newsletter form.
Customer accountsLogin, 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 keyTypeUsed for
custom.highlightsMulti-line textProduct 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.subtitleSingle line textSubtitle on product cards. If empty, the product type is shown.
custom.stage_colorColorGallery background color for this product.
reviews.ratingRatingStar 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.

  1. Click View update on the theme card.
  2. Shopify adds the updated theme to your library and keeps your settings and content.
  3. 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.