> ## Documentation Index
> Fetch the complete documentation index at: https://varaahi.vritservicespro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Answers to the questions merchants ask most about VARAHI — setup, customisation, performance, apps and troubleshooting.

# FAQ

> **Do I need to install any apps for VARAHI to work?**
>
> No. Cart, search, wishlist, filters, mega menu, bulk packs, and every section work
> on a stock Shopify store. Two optional apps unlock more:
> **Search & Discovery** (Shopify's own, free) enables metafield filters and
> related-product rules, and a **review app** such as Judge.me or Loox populates
> the reviews section.

> **The hero image is not showing on my homepage**
>
> The Hero Product section needs a product. Check that **Product** is set, and that
> the product you selected still exists — if it was deleted, VARAHI falls back to
> the first product in your store automatically, but you should re-point the setting
> so it does not change unexpectedly.

> **How do I change the colours?**
>
> **Theme settings → Colors.** You only need to set the primary, secondary and
> background. Every other surface derives from them. See
> [Color system](https://varaahi.vritservicespro.com/settings/colors.md).

> **Can I use my own fonts?**
>
> Yes, but it is more involved than changing a colour. VARAHI's type system depends
> on Inter and JetBrains Mono metrics. See [Typography](https://varaahi.vritservicespro.com/settings/typography.md#changing-the-fonts)
> for the four steps, and re-check the type scale afterwards.

> **Why is my icon showing as a word instead of a picture?**
>
> The Material Symbols font is a **subset**. It contains exactly the 44 glyphs the
> theme uses. Any other name renders as its raw word. The full list is in
> [Code reference](https://varaahi.vritservicespro.com/going-further/code-reference.md#supported-icon-names), and the fix
> is to add your glyph to the subset.

> **The cart button is cut off on mobile**
>
> Your logo wordmark is too long for the available width. Shorten the logo text,
> remove the sub-text, or switch to a **logo image** — an image scales down
> automatically, a long text wordmark does not.

> **Why is there no animation on my phone?**
>
> By design. Below 1024px the entire motion bundle is not downloaded, which is what
> keeps mobile pages fast. See
> [Performance](https://varaahi.vritservicespro.com/going-further/performance.md#mobile-has-no-motion).

> **The wishlist does not follow me between devices**
>
> Correct, and it is by design. The wishlist is stored in the shopper's own browser
> via `localStorage`. A server-side, cross-device wishlist needs an app.

> **How do the bulk packs work?**
>
> The bulk tier is a **presentation layer**. It sets the quantity and shows the
> per-unit price and the saving. If your bulk pack needs to be a separate SKU with
> its own inventory and price, use a bundles app. See
> [Hero Product](https://varaahi.vritservicespro.com/sections/hero-product.md#the-bulk-pack-tier).

> **My Lighthouse score is much lower on the theme dev server**
>
> Expected. The dev server compiles Liquid on every request, serves assets
> uncompressed, and injects about 3 MB of Shopify development tooling that does
> not exist on a published store. Audit the **published** store. See
> [Performance](https://varaahi.vritservicespro.com/going-further/performance.md#auditing-your-own-store).

> **Can I edit the theme code?**
>
> You can, but read [Code reference](https://varaahi.vritservicespro.com/going-further/code-reference.md#which-files-can-you-edit)
> first. Editing existing section files is what creates upgrade conflicts. Prefer
> new files, and keep custom CSS in a single `assets/custom.css`.

> **How do I add a language?**
>
> **Settings → Languages → Add language**, then copy the theme locale into it. The
> full walkthrough is in
> [Localization guide](https://varaahi.vritservicespro.com/going-further/localization-guide.md).

> **My filter sidebar is empty**
>
> Filtering is driven by the **Search & Discovery** app and your product
> metafields. Install and configure Search & Discovery, then define your filters.

> **The product reviews are not showing**
>
> The section reads from product metafields. Check that your review app writes to
> `reviews.rating`, `reviews.rating_count` and `reviews.content`. See
> [Product reviews](https://varaahi.vritservicespro.com/sections/product-reviews.md).

> **How do I update the theme without losing my changes?**
>
> Theme-editor changes survive updates. Code changes do not, and your theme will be
> flagged as customised. Keep custom code in separate files so re-applying it takes
> minutes. See [Installation](https://varaahi.vritservicespro.com/installation.md#upgrading).

> **Can I remove the announcement bar?**
>
> It is already removed. VARAHI has no announcement bar — the header begins the
> page directly.

***

## Still stuck?

> **[Support](https://www.vritservicespro.com/varahi-shopify-theme/)**
>
> Where to get help and what to include.

> **[Code reference](https://varaahi.vritservicespro.com/going-further/code-reference.md)**
>
> The technical details.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.