> For the complete documentation index, see [llms.txt](https://staylime.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://staylime.com/docs/volume-themes/faq.md). # FAQ - [Overview](https://staylime.com/docs/volume-themes/faq/overview.md): Browse frequently asked questions about the Volume Shopify theme organized by topic: setup, navigation, products, cart and performance. - [Theme setup & updates](https://staylime.com/docs/volume-themes/faq/theme-setup-and-updates.md): Installing Volume, moving it between stores, updating to a new version and keeping your customizations safe. - [Will updating Volume erase my customizations?](https://staylime.com/docs/volume-themes/faq/theme-setup-and-updates/will-updating-volume-erase-my-customizations.md): What a Volume update keeps, what it does not, and how to move to a new version without losing your work. - [My collection pages are empty after install](https://staylime.com/docs/volume-themes/faq/theme-setup-and-updates/my-collection-pages-are-empty-after-install.md): Why collection links break and collection pages look empty right after you install Volume, and how to point them at your own collections. - [Can I move Volume to another store, or install it from a ZIP?](https://staylime.com/docs/volume-themes/faq/theme-setup-and-updates/can-i-move-volume-to-another-store-or-install-it-from-a-zip.md): Moving Volume to a different Shopify store, installing from a ZIP file, and how the theme licence works. - [Where should I put custom CSS so an update does not wipe it?](https://staylime.com/docs/volume-themes/faq/theme-setup-and-updates/where-should-i-put-custom-css-so-an-update-does-not-wipe-it.md): Where to put custom CSS in Volume so that it survives a theme update, and what to avoid editing. - [Navigation & header](https://staylime.com/docs/volume-themes/faq/navigation-and-header.md): Transparent and sticky headers, Smart Category Menu, mega menus and the mobile menu drawer. - [My header is transparent over the banner — how do I make it solid?](https://staylime.com/docs/volume-themes/faq/navigation-and-header/my-header-is-transparent-over-the-banner-how-do-i-make-it-solid.md): Why the Volume header sits on top of the first section, and how to give it a solid background on desktop and mobile. - [Smart Category Menu does not highlight my category](https://staylime.com/docs/volume-themes/faq/navigation-and-header/smart-category-menu-does-not-highlight-my-category.md): How Volume's Smart Category Menu decides which parent menu item to highlight, and why it needs a metafield to work. - [Mega menu: columns, banners, width and clickable parents](https://staylime.com/docs/volume-themes/faq/navigation-and-header/mega-menu-columns-banners-width-and-clickable-parents.md): Column headings, banners, width and the short variant of the Volume mega menu, plus how the block finds the menu item it belongs to. - [Why is my mobile menu different from the desktop menu?](https://staylime.com/docs/volume-themes/faq/navigation-and-header/why-is-my-mobile-menu-different-from-the-desktop-menu.md): Why the Volume mobile menu can show different links from the desktop header, and where to edit each one. - [Can I make the mega menu column headings non-clickable?](https://staylime.com/docs/volume-themes/faq/navigation-and-header/can-i-make-the-mega-menu-column-headings-non-clickable.md): Why mega menu column headings are always links in Volume, and the Custom CSS rule that turns them into plain labels. - [Products & variants](https://staylime.com/docs/volume-themes/faq/products-and-variants.md): Colour swatches, variant media, size guides, linked products, custom options and the product gallery. - [My color swatches show up as pills](https://staylime.com/docs/volume-themes/faq/products-and-variants/my-color-swatches-show-up-as-pills.md): Why a variant option renders as pills instead of colour swatches in Volume, and the two conditions it has to meet. - [How do I show only the images of the selected variant?](https://staylime.com/docs/volume-themes/faq/products-and-variants/how-do-i-show-only-the-images-of-the-selected-variant.md): How to make the Volume product gallery show only the images that belong to the selected variant, using image alt text. - [Where is the size guide, and why does it show on products without sizes?](https://staylime.com/docs/volume-themes/faq/products-and-variants/where-is-the-size-guide-and-why-does-it-show-on-products-without-sizes.md): Where the Volume size guide lives, how it is matched to an option, and why it appears on products with no variants. - [How do I link color ways that are separate products?](https://staylime.com/docs/volume-themes/faq/products-and-variants/how-do-i-link-color-ways-that-are-separate-products.md): Linking colourways that live as separate products in Volume, using the custom metafields the theme reads. - [I added a block but it does not show on the product page](https://staylime.com/docs/volume-themes/faq/products-and-variants/i-added-a-block-but-it-does-not-show-on-the-product-page.md): Five reasons a block you added in the Volume theme editor does not appear on the live product page. - [Product gallery: layout, ratios and zoom](https://staylime.com/docs/volume-themes/faq/products-and-variants/product-gallery-layout-ratios-and-zoom.md): Gallery layouts, image ratios and zoom behaviour on the Volume product page, and what to do about blurry or cropped photos. - [Can customers add their own text, choices or files to a product?](https://staylime.com/docs/volume-themes/faq/products-and-variants/can-customers-add-their-own-text-choices-or-files-to-a-product.md): Adding personalization fields to a Volume product page with custom options, and what they do and do not affect. - [My custom badge does not show, or shows in the wrong color](https://staylime.com/docs/volume-themes/faq/products-and-variants/my-custom-badge-does-not-show-or-shows-in-the-wrong-color.md): How Volume reads the custom.badge metafield, why an unmatched badge comes out black, and why a variant badge never appears on a product card. - [Cart & checkout](https://staylime.com/docs/volume-themes/faq/cart-and-checkout.md): Add to cart and sticky buy buttons, free shipping progress, payment icons, cart recommendations and gift cards. - [The Add to cart button is missing](https://staylime.com/docs/volume-themes/faq/cart-and-checkout/the-add-to-cart-button-is-missing.md): What to check when the Add to cart button is missing from a Volume product page, and how the sticky buy bar works. - [My free shipping bar shows the wrong amount](https://staylime.com/docs/volume-themes/faq/cart-and-checkout/my-free-shipping-bar-shows-the-wrong-amount.md): How Volume decides the free shipping threshold, and why editing the theme setting sometimes has no effect. - [Payment icons are missing, grey, or the wrong ones](https://staylime.com/docs/volume-themes/faq/cart-and-checkout/payment-icons-are-missing-grey-or-the-wrong-ones.md): Where Volume's payment icons come from, why you cannot pick them individually, and the two separate blocks that show them. - [Cart recommendations and Recently viewed look empty](https://staylime.com/docs/volume-themes/faq/cart-and-checkout/cart-recommendations-and-recently-viewed-look-empty.md): Why Cart recommendations, Product recommendations and Recently viewed products render empty in the Volume theme editor and on the storefront. - [How do I let customers send a gift card to someone else?](https://staylime.com/docs/volume-themes/faq/cart-and-checkout/how-do-i-let-customers-send-a-gift-card-to-someone-else.md): Turning on the gift card recipient form in Volume so customers can send a gift card by email with a message. - [How do I run the store as a catalogue, without checkout?](https://staylime.com/docs/volume-themes/faq/cart-and-checkout/how-do-i-run-the-store-as-a-catalogue-without-checkout.md): What Disable shopping functionality switches off in Volume, what it leaves visible, and the two buttons you have to turn off yourself. - [What is the "Before discounts" line in the cart?](https://staylime.com/docs/volume-themes/faq/cart-and-checkout/what-is-the-before-discounts-line-in-the-cart.md): How Volume calculates the Before discounts and Savings rows in the cart, the compare-at price setting behind them, and why hiding the row also hides discount names. - [Performance & troubleshooting](https://staylime.com/docs/volume-themes/faq/performance-and-troubleshooting.md): Speed scores, Core Web Vitals, conflicts with third-party apps and browser-specific display issues. - [My PageSpeed score is low](https://staylime.com/docs/volume-themes/faq/performance-and-troubleshooting/my-pagespeed-score-is-low.md): How to read a PageSpeed or Lighthouse score on a Volume store, which theme settings actually affect it, and what usually costs the points. - [The store feels laggy when clicking or scrolling](https://staylime.com/docs/volume-themes/faq/performance-and-troubleshooting/the-store-feels-laggy-when-clicking-or-scrolling.md): What causes a high INP or a laggy feel on a Volume store, and which theme settings to check first. - [An app or some custom code broke my layout](https://staylime.com/docs/volume-themes/faq/performance-and-troubleshooting/an-app-or-some-custom-code-broke-my-layout.md): How to tell whether an app, a piece of custom code or the theme broke your layout, and how to isolate it. - [It only looks wrong in one browser, or only on phones](https://staylime.com/docs/volume-themes/faq/performance-and-troubleshooting/it-only-looks-wrong-in-one-browser-or-only-on-phones.md): Diagnosing display problems that appear in only one browser or only on phones, including content running off the edge and broken word wrapping. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://staylime.com/docs/volume-themes/faq.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.