Build your store with confidence.
A practical guide to installing, configuring and customizing Avenquill. The wording follows the current Shopify theme editor so merchants can find settings quickly.
Getting started
Avenquill is configured from Shopify’s theme editor. Normal store setup does not require editing theme code.
- Upload the theme ZIP and keep it unpublished while configuring.
- Start with Theme settings: typography, colors, layout, shapes, brand assets and store utilities.
- Connect menus, products, collections, blog content, Markets and social links.
- Review Home, Product, Collection, Search, Cart, Blog, Article, About, Contact and Password templates.
- Test variants, cart, filters, search, localization, mobile layout and checkout links before publishing.
Theme settings
Typography, layout, shapes and colors
Use the global controls for heading/body fonts, Content side margin, corner radii, background, text, accent and button colors.
Store utilities
Quick View, free-shipping progress and the back-to-top control live here. Product-card settings used across Collection and Search are shared globally so merchants do not have to configure the same card options repeatedly.
Newsletter
Theme settings → Newsletter contains the global Eyebrow, Heading and Text. Newsletter sections use this global content by default through Use global newsletter content. Turn it off when one section needs its own local copy. Form behavior and colors remain section-level.
Header, announcement bar & mega menu
The Announcement bar is a separate section above the Header. It has text, an optional link and simple color controls, keeping the Header panel focused on branding, navigation, account access, search, predictive search, localization and mobile navigation.
Set up the mega menu
- Create the desired nested structure in Shopify Navigation.
- Top-level navigation items with dropdown links use Avenquill’s mega-menu presentation automatically.
- Add Mega menu blocks only when you want editorial promotion tiles beside the navigation links.
- Mega menu blocks map to top-level dropdown items in the same order: first block to first dropdown item, second block to second dropdown item, and so on.
- Each promotion block can add up to three optional tiles with image, eyebrow, heading and link.
Homepage & section reference
Collection cards
Use one to four selected collections. Classic and Editorial layouts automatically create a deliberate centered composition for 1–4 cards, with image overrides and responsive mobile behavior.
Collection hero
Collection pages can use a Single feature image or an Editorial image pair. Pair mode uses the collection image plus the first different product image it can find; if no distinct second image is available, Avenquill falls back to a single-image hero instead of duplicating the same media. Mobile keeps the primary image full width.
Image with text
Avenquill now uses one shared Image with text section across Home, About and Collection templates. It supports image position, desktop/mobile imagery, alignment, copy and an optional button. Alternating About-page layouts can still be built by switching left/right media position.
Benefits bar & Values
Benefits bar supports up to six concise USP items. Each benefit can use an Avenquill line icon or an optional custom icon, a short Heading, a Short description and an optional link. Desktop and landscape tablet layouts share the row evenly; phones and portrait tablets use a two-column grid (four items appear as 2×2; six appear as 2×3). This layout responds automatically to viewport size; there is no separate mobile-layout setting. The row height is a minimum rather than a fixed height, so longer merchant copy can wrap without being clipped. Values remains a separate brand-level section for longer principles with Icon, Heading and Text blocks.
Before and after
Choose Landscape, Classic, Square or Portrait. Taller ratios are intentionally constrained so the comparison stays balanced instead of becoming excessively tall.
About quote & Cinematic media
White-text image treatments use a consistent darker overlay language so placeholders and real media communicate the intended final presentation clearly in the Theme Editor.
Contact form
The Contact form includes optional Help item blocks for practical contact information and an optional Order number field, enabled by default. Keep the extra field on when order-specific support is common, or turn it off for a simpler general-contact form.
Section spacing
New and consolidated sections use clear Top spacing and Bottom spacing controls where merchant adjustment is useful, rather than inconsistent or overly broad vertical-spacing settings.
Product pages
Product information is block-based so merchants can reorder the buying hierarchy without editing code. Blocks include breadcrumbs, vendor, title, price, SKU, inventory, description, variants, quantity, buy buttons, complementary products, share, pickup availability, app blocks and Custom Liquid.
Product Composer
Use Product Composer and the product storytelling sections to build longer premium product pages while keeping the core buying information focused. For the design rationale behind that structure, read How to Build an Editorial Shopify Product Page.
Product Details accordion
Accordion rows can contain rich text, reusable page content and Custom Liquid. They can also include an optional document download for care guides, size guides, warranty PDFs or technical sheets. If the link is filled and the label is blank, Avenquill uses a localized default download label.
Dynamic sources & metafields
For product-specific content, connect compatible section or block settings to Shopify metafields using dynamic sources. Shared content such as Shipping & Returns can stay static or come from a reusable page.
Product recommendations
Recommendations use Shopify recommendation data. If no data is available, the storefront stays clean. The Theme Editor shows a small helper explaining why the section is empty.
Product craft details
The optional final supporting text is labelled Closing note in the editor.
Swatches & variants
Avenquill supports Shopify’s native swatch data and common color option names. Product-card swatches are controlled by the shared global product-card settings instead of separate duplicated controls on every grid.
- Add a Variant picker block to Product information or Featured product.
- Enable swatches.
- Use native Shopify swatch colors or images for the most accurate result.
- Assign variant media in Shopify when the gallery should follow color/material changes.
Collections & search
Collection and Search use the same product-card system. Shared card options live under Theme settings → Store utilities.
Product grid
Configure products per page, desktop/mobile columns, sorting, product count, filters and filter swatches. Product-card details such as vendor, price, badges, hover image, card swatches and Quick Add come from shared global settings.
Search
Search keeps search-specific controls only. Product results and article/page results use their own counts, while filtering and sorting apply specifically to products.
Editor wording is explicit: Show color swatches in filters refers to filter values; Show color swatches on product cards refers to product cards.
Cart & checkout
Avenquill includes a cart drawer and full cart page with quantity updates, discounts, selling-plan information, unit pricing, tax messaging, notes and accelerated checkout surfaces when available.
The empty-cart button uses Shopify’s all-products collection route as a fallback when no custom link is provided.
Free-shipping progress
Enable this only when the threshold matches the store’s real shipping configuration. Enter the amount in the store currency; Avenquill shows the progress indicator only when the customer is browsing in that same currency. Keep it disabled when no matching shipping rule exists.
Images, video & focal points
Use high-resolution source media, Shopify focal points where relevant, dedicated mobile images where available, and a fallback/poster image for video.
Slideshow, Cinematic media, Shoppable scene and Material notes support video-oriented layouts. Always test controls, autoplay behavior and mobile loading in the real storefront.
Localization
Avenquill uses Shopify’s native country/region and language forms. The current theme includes English, Spanish, German, French and Italian storefront locale files. Published languages, translations, currencies, domains and market availability remain managed in Shopify.
The selectors only show meaningful choices when more than one relevant language or market option is available to the storefront.
Apps & Custom Liquid
Product information and Featured product accept Shopify app blocks. Avenquill also includes a general Apps section and Custom Liquid insertion points for merchant-controlled extensions.
Troubleshooting
Product recommendations are empty
Shopify may not return recommendation data immediately. The storefront stays empty by design; the Theme Editor helper is only for merchant guidance.
Swatches do not appear
Confirm the Variant picker has swatches enabled and that Shopify option values contain native swatch data or use a recognized color option name.
Collection filters are empty
Configure storefront filters in Shopify Search & Discovery, then enable filters in the collection/search template.
Localization selectors are missing
Confirm more than one country/region or published language is available, then enable the desired selector.
Still stuck?
Open Avenquill support and include the template, expected behavior, actual behavior and screenshots.
Changelog
Avenquill 1.0.0
- Collection Cards refined for 1–4 centered Classic/Editorial layouts.
- Mega menu simplified around Shopify Navigation as the single source of truth.
- Announcement bar separated from Header.
- Global Newsletter content added with section-level override.
- Image with text consolidated into one reusable section.
- Benefits bar refined with heading + short description blocks, line/custom icons, equal desktop columns and a responsive two-column phone/portrait tablet layout; Values remains a separate brand section.
- Product Details accordion supports optional document downloads and dynamic product sources.
- Product recommendations receive an editor-only empty-data helper.
- Collection/Search share product-card settings and clearer swatch wording.
- Search result counts distinguish products from article/page results.
- Global button hover behavior, Password layout, About quote and media-overlay polish refined.