Chapter 06 · Support Policy, Custom Code & FAQ
Custom code warning, support policy & FAQ
Clear expectations help you launch with confidence. Review our code safety precautions, what is covered under your Averdane theme purchase, and quick answers to the most frequent setup questions.
1. Editing theme code safely (important warning)
Before modifying any Liquid, CSS, JSON template, or JavaScript file under Online Store → Themes → … → Edit code, always select Duplicate first to save an untouched backup copy. Direct edits to Liquid files can prevent automatic Shopify Theme Store updates and may introduce layout or checkout regressions if syntax errors occur.
All examples in this documentation use built-in Theme Editor settings, Custom data metafields, and native metaobjects that require zero code changes. Any custom coding modifications you or a third-party developer apply to theme files are outside standard theme support. If your store requires bespoke template engineering, custom third-party integrations, or paid alteration pricing logic, we strongly recommend hiring a certified Shopify Partner from the Shopify Partner Directory.
2. Theme support policy & SLA
As a Shopify Theme Partner, our team stands behind Averdane with dedicated engineering support:
- Response time SLA: We reply to all support requests submitted through our Support Contact Form within two business days (Monday through Friday, excluding public holidays). Every submission triggers an immediate automated confirmation email with your ticket reference number.
- Critical bug priority: Verified storefront-breaking defects, checkout blockers, or mobile usability regressions in unmodified Averdane releases are prioritized for immediate patching.
| Included with your theme purchase (Free) | Not included in theme support |
|---|---|
| Fixing verified bugs or visual defects in an unmodified version of Averdane. | Custom design changes, bespoke sections, or custom Liquid/CSS/JavaScript development. |
| Answering questions about any built-in Averdane setting, preset, section, or metafield documented here. | Installing, debugging, or styling third-party apps, scripts, or external widgets. |
| Guidance on configuring native Shopify OS 2.0 features supported by the theme (color schemes, menus, pickup, gift cards). | Troubleshooting issues introduced by custom code edits or leftover snippets from uninstalled apps. |
| Ongoing theme updates published through the official Shopify Theme Store. | Store setup services, product photography editing, catalog CSV imports, or SEO copywriting. |
3. Frequently asked questions (FAQ)
Can I use the Monolith or Salon layout structure with my own fonts and brand colors?
Yes. Structural geometry is controlled independently under Theme settings → Layout → Layout style (Averdane, Monolith, Salon, or Solstice). Changing your fonts under Typography or colors under Colors will never reset your chosen preset’s grid rules, borders, or corner styling.
How do I group product gallery photos by color so only the selected color appears?
In Shopify Admin → Products, open each product photo and start its Alt text with the exact color option name—for example Tobacco — front or Black — detail—or assign it as the variant image. Leave shared neutral shots (such as fabric labels or packaging) without a color prefix so they remain visible for every color.
How do I link separate single-color products together as swatches on the product page?
Create a Product metafield with namespace and key custom.siblings of type Product (List of products), select the companion products on each item, and enable Show sibling products inside Product information → Variant picker.
Do I have to enter both centimeters and inches in the Size Guide?
No. Enter all table rows once in centimeters separated by vertical pipes (|). Averdane’s built-in unit toggle automatically calculates inches (rounding whole cm to the nearest ½ in and decimals to 0.1 in).
Does Online Alterations add a surcharge to the product price at checkout?
No. Online Alterations saves the shopper’s chosen service and measurement (for example Alteration: Hem — 72 cm) as native Shopify line item properties on that item, which never add hidden fees. If you wish to charge for alterations, keep online alterations for complimentary hemming or pair your catalog with a dedicated paid service product or Shopify app.
Why aren’t alteration fields showing on my product page?
Check three places: (1) the product’s custom.alterations_available boolean metafield must be true, (2) Theme settings → Alterations → Enable online alterations must be checked, and (3) the product’s custom.alterations metafield must reference at least one alteration metaobject entry (and the Alterations block must be present in Product information).
How do I enable inline size Quick Add on collection product cards?
Open a collection template in the Theme Editor, select the Collection section, and check Enable quick add under the Product card heading. Products with a Size option display their available sizes on hover; other products open Quick View.
How do I set up Complementary Products in “Complete the look” and the Cart Drawer?
Install Shopify’s free official Search & Discovery app, open Recommendations, and assign Complementary products to your garments. Both the PDP Complete the look section and the Cart Drawer pairing rail read those native pairings automatically.
How do I set up collection filtering by color, price, availability, or material?
Collection and search filters use Shopify’s native storefront filtering. Configure active filter groups (Availability, Price, Color, Size, Product type, or custom metafields like custom.material) inside the free Shopify Search & Discovery app under Filters.
Does the Stockists page require a Google Maps or Mapbox API key?
No. Averdane’s Stockists directory searches entries locally with accent-insensitive matching, calculates Use my location distances in the browser when granted by the visitor, and draws its optional schematic map using an embedded public-domain vector coastline—zero external API keys or billing required.
Why is the Free Shipping Progress Bar hidden for international shoppers?
The Free shipping threshold in Theme settings → Cart is entered in your store’s primary currency. To prevent inaccurate threshold math when exchange rates fluctuate across currencies, Averdane automatically hides the bar when a shopper browses in a non-primary currency.
Does Averdane support multiple languages, multi-currency Markets, and RTL scripts?
Yes. Every storefront string is externalized in locales/, country/region and language selectors are built into the Header and Footer, and CSS logical properties automatically mirror drawers, arrows, and grids when an RTL language (such as Arabic or Hebrew) is active.
How do I preview the Promotional Popup while designing in the Theme Editor?
Select the Promotional popup section and set Display mode to Testing mode so it renders on every reload without dismissal cookies. Remember to switch Display mode to Enabled (or Disabled) before launching your store.
How do I add customer product reviews?
Averdane includes a Product reviews section that reads Shopify’s standard reviews.rating and reviews.rating_count metafields and accepts @app blocks from any Theme Store-compatible review app inside both Product information and Product reviews.
How do I update Averdane when a new version is released?
If you have not edited theme code files directly, Shopify notifies you in Online Store → Themes whenever a new version is available, copying your JSON templates and Theme Editor settings into a new draft theme so you can preview before publishing.