Avelio Help center

Documentation

Avelio theme guide

Avelio is built for merch, gifts and custom goods: personalized products with a live preview, team and bulk orders, limited drops and gift boxes. This guide follows the names you see in the theme editor.

Getting started

  1. In your Shopify admin, go to Online Store > Themes and add Avelio from the Shopify Theme Store.
  2. Click Customize to open the theme editor. Nothing is visible to your customers until you publish the theme.
  3. Create your navigation in Content > Menus. The header uses the main menu and the footer uses the footer menu by default.
  4. Add your logo, colors and fonts in Theme settings.
  5. Build your home page by adding, reordering and hiding sections in the left panel.
  6. Assign the right product template to each product (see Product pages).
  7. Preview on desktop and mobile, then click Publish.
Demo images are not included with the theme. Use your own product photos. For the best result, use the same proportions for all product images.

Theme settings

Open the theme editor and click the settings icon. Settings are grouped as follows.

GroupWhat you control
ColorsColor schemes. Each scheme defines a background, text, accent and button colors. Every section lets you pick one scheme.
TypographyHeading and body fonts from the Shopify font library, plus heading and body size.
Layout and shapesPage width, corner radius, button style, sticker-style hard shadows on cards and buttons, wavy section dividers and reveal on scroll.
Product cardsImage ratio, second image on hover, quick add, quick view, vendor, color swatches and the personalization required tag.
CartCart type (drawer or page), free shipping threshold, order notes, gift message and gift wrap toggle.
Merch toolsProduction time, made-to-order tag, bulk quote page and limited drop tag.
Social mediaLinks to your Instagram, TikTok, Pinterest, Facebook and YouTube profiles. Empty fields are hidden.
SearchPredictive search on or off.
FaviconThe small icon shown in the browser tab.

Merch tools in detail

  • Production time: minimum and maximum business days. Products with the made-to-order tag show an estimated shipping and delivery window.
  • Made-to-order product tag: default made-to-order. Add this tag to a product to show the production estimate.
  • Limited drop tag: default limited. Products with this tag get a Limited badge.
  • Bulk quote page: pick a page that uses the page.quote template. Product pages can link to it with the product already filled in.
  • Announcement bar: add one or more announcements. Several announcements rotate.
  • Header: logo, menu, search, account and cart. Menus support nested levels. Add Mega menu image blocks to show a promotional image inside a dropdown.
  • Footer: build it with Menu, Text and Newsletter blocks. Payment icons and the country and language selectors appear automatically when your store uses them.

Sections

Click Add section on any page. These sections are available.

SectionUse it for
HeroA large opening image or video with a heading and up to two buttons. Choose text over media or a split layout.
Scrolling textA moving line of short messages such as shipping or returns.
Collection listShop by category tiles, round or square.
Featured collectionA row or grid of products from one collection.
Featured productOne product with its full buying options, anywhere on the store.
Icon columnsShort benefits with an icon or image, such as made to order or easy returns.
Drop countdownAnnounce a limited release with a launch date and a product.
Bundle builderLet customers pick several products from a collection and add them together as a box.
Shop the lookAn image with clickable hotspots linked to products.
Before / afterTwo images compared with a draggable handle, for example blank and personalized.
Image with textA story block with an image, text, key points and a button.
Promo bannerA compact call to action with an image.
TestimonialsCustomer quotes with a star rating.
FAQCollapsible questions. The section also outputs FAQ structured data for search engines.
Blog postsYour latest articles.
Logo listClient or press logos.
VideoA Shopify hosted, YouTube or Vimeo video.
Map and hoursYour address, opening hours and a map image.
Recently viewedProducts the visitor looked at before. It stays hidden until there is something to show.
NewsletterAn email signup form.
Rich textA heading, text and a button.
Contact formA contact form for any page.
Custom LiquidYour own Liquid or HTML.
AppsA place for app blocks on any page.
For Before / after, use two images with the same proportions and the same framing. The handle works with a mouse, touch and the keyboard arrow keys.

Product pages

Avelio ships with three product templates. Assign a template on the product page in your Shopify admin, under Theme template.

TemplateBest for
Default productReady-made products with a standard variant picker and buy buttons.
personalizedProducts customers customize with text or a logo and a live preview.
bulkTeam and event orders with a size order grid, a team roster and volume pricing.

The Product information section is made of blocks you can add, remove and reorder: Text, Vendor, Title, Price, SKU, Variant picker, Size guide, Personalizer, Volume pricing, Size order grid, Team roster, Quantity, Buy buttons, Delivery estimate, Description, Collapsible tab, Notice, Custom Liquid and app blocks.

  • Variant picker: pills or dropdown, with color swatches when available.
  • Size guide: opens a size table in a popup. Enter one row per line with cells separated by |. The first row is the header. Connect the field to a metafield to use a different table per product.
  • Delivery estimate: shows ordered, ships and delivered dates based on the production time in Theme settings.
  • Sticky add to cart bar: a section setting. When on, a compact bar with the price and the add to cart button appears once the main button scrolls out of view.

Personalized products

Add the Personalizer block to a product template, or use the personalized template where it is already in place. What customers enter is saved on the order as line item properties, so your team sees it in the order details.

  • Text field label, Placeholder and Max characters. Leave the label empty to hide the text field.
  • Text is required: blocks add to cart until the text is filled in.
  • Let customers choose a font.
  • Ink colors: a list of Name:hex pairs separated by commas, for example Black:#141414, White:#ffffff.
  • Allow logo / artwork upload: customers upload a .png, .jpg or .pdf file. Images are previewed on the product photo.
  • Placements: where the print can go. One entry per placement, written Name:horizontal:vertical:width in percent of the image, separated by commas. Example: Center chest:50:42:34, Left chest:62:32:14.
  • Let customers resize their logo and Show the print area outline.
The preview is a visual guide for the customer. It does not create a print-ready file. Always check the uploaded artwork on the order before production.

Products with the Personalization required tag (default personalize) or the personalized template cannot be added from a product card. The card sends the customer to the product page instead.

Team and bulk orders

Size order grid

The Size order grid block lists every variant on one screen with its own quantity. Customers enter the quantities they need and add everything to the cart in one click. Options: heading, text, show unit price and hide sold out variants.

Team roster

The Team roster block lets customers add one line per piece with a name, an optional number and a size. Each line is added to the cart as its own item with the name and number saved on the order. Options: ask for a number, max characters per name and max lines.

Volume pricing

The Volume pricing block displays the quantity price breaks set in Shopify for the current customer. Quantity price breaks are managed in Shopify catalogs, which depend on your Shopify plan. When no price break applies, the block can show a link to your bulk quote page.

Quote page

Create a page, assign the page.quote template, then select it in Theme settings > Merch tools > Bulk quote page.

Product cards and quick view

  • Enable quick add: products with a single variant get an add to cart button on the card.
  • Quick view on products with options: products with several variants open in a popup where the customer picks options and adds to the cart without leaving the page.
  • Show color swatches, Show vendor, Show second image on hover and Image ratio.

Cart

  • Cart type: a slide-out drawer or a full cart page.
  • Free shipping threshold: shows a progress bar. Set the amount to match your shipping rules and list the eligible country codes. An amount of 0 hides the bar.
  • Enable order notes, Gift message label and Show gift wrap toggle. Gift options are saved as cart attributes on the order.
  • Discounts, taxes and accelerated checkout buttons follow your Shopify settings.

Collections and search

  • Collection and search pages include sorting and filters. Filters are managed with the free Shopify Search & Discovery app, where you choose which filters appear.
  • Predictive search suggests products, collections, pages and articles as the customer types.

Languages and currencies

Avelio is translated into English, French, German, Spanish, Italian and Arabic, with full right-to-left layout for Arabic. Publish languages in Settings > Languages. The language and country selectors appear automatically when more than one option is available.

Theme text is translated for you. Your own content, such as product titles, section headings and block labels, is translated with the free Shopify Translate & Adapt app.

Apps

Avelio supports app blocks on product pages, in the featured product section, in the cart and in the Apps section. Add them from the theme editor with Add block. When an app changes the cart, the cart drawer refreshes on its own.

We cannot test every app. If something looks wrong after installing an app, turn the app off to confirm the cause, then contact the app developer. See the support policy.

Updating the theme

Updates are free and delivered through the Shopify Theme Store. When a new version is available, a notice appears next to the theme in Online Store > Themes.

  1. Click the update notice and add the new version to your theme library. It is added as an unpublished copy.
  2. Preview the new copy and check your key pages.
  3. Publish it when you are ready. Your previous version stays in your library as a backup.

Everything you set up in the theme editor is carried over: settings, sections, templates and translations edited in the language editor.

Code edits are not carried over. If the theme code was changed, by you, a developer, an app or an AI tool, those changes must be applied again by hand on the new version. Keep a written list of every code change.

Customizing the code

You rarely need to edit code. Start with theme settings, sections, blocks and the Custom Liquid section, which survive updates.

If you decide to edit the code:

  • Duplicate your theme first, in Online Store > Themes, and work on the copy.
  • Code changes are not covered by our support and are not kept during updates.
  • For custom development, we suggest hiring a Shopify Partner.

FAQ

Do I pay again for updates?

No. Updates are free for the store that bought the theme.

Can I use Avelio on several stores?

A license covers one store. Each additional store needs its own license from the Shopify Theme Store.

Are the demo images included?

No. The demo store shows what the theme can do. Use your own images.

Which image sizes work best?

Product images: 2000 x 2000px (recommended), same proportions for all products. Hero: 2400 x 1350px (recommended). Before / after: two images with identical proportions.

Where do I see the text or logo a customer entered?

On the order, under each line item. Text, font, ink color, placement and the uploaded file are saved as line item properties.

The quick view button does not show on a product. Why?

Quick view appears on available products with several variants. Single variant products use quick add. Products that require personalization link to the product page.

The delivery estimate does not show. Why?

Add the made-to-order tag to the product, and check that the Delivery estimate block is in the product template.

The volume pricing block is empty. Why?

It shows quantity price breaks set in Shopify catalogs for the current customer. Without price breaks, only the bulk quote link is shown, if enabled.

Can I change the text of buttons and labels?

Yes. In Online Store > Themes, open the theme menu and choose Edit default theme content.

Is the theme compatible with my app?

Avelio supports app blocks and app embeds, the standard way apps connect to themes. We cannot guarantee every app. Ask the app developer if their app supports Online Store 2.0 themes.

How do I get help?

Use the support form. Include your store URL and screenshots. We reply within 2 business days.