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
- In your Shopify admin, go to Online Store > Themes and add Avelio from the Shopify Theme Store.
- Click Customize to open the theme editor. Nothing is visible to your customers until you publish the theme.
- Create your navigation in Content > Menus. The header uses the main menu and the footer uses the footer menu by default.
- Add your logo, colors and fonts in Theme settings.
- Build your home page by adding, reordering and hiding sections in the left panel.
- Assign the right product template to each product (see Product pages).
- Preview on desktop and mobile, then click Publish.
Theme settings
Open the theme editor and click the settings icon. Settings are grouped as follows.
| Group | What you control |
|---|---|
| Colors | Color schemes. Each scheme defines a background, text, accent and button colors. Every section lets you pick one scheme. |
| Typography | Heading and body fonts from the Shopify font library, plus heading and body size. |
| Layout and shapes | Page width, corner radius, button style, sticker-style hard shadows on cards and buttons, wavy section dividers and reveal on scroll. |
| Product cards | Image ratio, second image on hover, quick add, quick view, vendor, color swatches and the personalization required tag. |
| Cart | Cart type (drawer or page), free shipping threshold, order notes, gift message and gift wrap toggle. |
| Merch tools | Production time, made-to-order tag, bulk quote page and limited drop tag. |
| Social media | Links to your Instagram, TikTok, Pinterest, Facebook and YouTube profiles. Empty fields are hidden. |
| Search | Predictive search on or off. |
| Favicon | The 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.quotetemplate. Product pages can link to it with the product already filled in.
Header, menus and footer
- 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.
| Section | Use it for |
|---|---|
| Hero | A large opening image or video with a heading and up to two buttons. Choose text over media or a split layout. |
| Scrolling text | A moving line of short messages such as shipping or returns. |
| Collection list | Shop by category tiles, round or square. |
| Featured collection | A row or grid of products from one collection. |
| Featured product | One product with its full buying options, anywhere on the store. |
| Icon columns | Short benefits with an icon or image, such as made to order or easy returns. |
| Drop countdown | Announce a limited release with a launch date and a product. |
| Bundle builder | Let customers pick several products from a collection and add them together as a box. |
| Shop the look | An image with clickable hotspots linked to products. |
| Before / after | Two images compared with a draggable handle, for example blank and personalized. |
| Image with text | A story block with an image, text, key points and a button. |
| Promo banner | A compact call to action with an image. |
| Testimonials | Customer quotes with a star rating. |
| FAQ | Collapsible questions. The section also outputs FAQ structured data for search engines. |
| Blog posts | Your latest articles. |
| Logo list | Client or press logos. |
| Video | A Shopify hosted, YouTube or Vimeo video. |
| Map and hours | Your address, opening hours and a map image. |
| Recently viewed | Products the visitor looked at before. It stays hidden until there is something to show. |
| Newsletter | An email signup form. |
| Rich text | A heading, text and a button. |
| Contact form | A contact form for any page. |
| Custom Liquid | Your own Liquid or HTML. |
| Apps | A place for app blocks on any page. |
Product pages
Avelio ships with three product templates. Assign a template on the product page in your Shopify admin, under Theme template.
| Template | Best for |
|---|---|
| Default product | Ready-made products with a standard variant picker and buy buttons. |
| personalized | Products customers customize with text or a logo and a live preview. |
| bulk | Team 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:hexpairs separated by commas, for exampleBlack:#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:widthin 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.
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.
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.
- Click the update notice and add the new version to your theme library. It is added as an unpublished copy.
- Preview the new copy and check your key pages.
- 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.
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.