> ## 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.

# Accounts & reviews

> Shopify's native customer accounts integrated into the header, plus review metafields rendered cinematically.

# Accounts & reviews

Two trust features that most themes treat as afterthoughts.

***

## Customer accounts

VARAHI uses **Shopify's native customer accounts** — the same accounts your customers already have from the standard "Customer accounts" app — rendered inside the header
in the theme's own styling.

| Property | Detail |
| - | - |
| **Authentication** | Shopify's, including new customer accounts (email OTP, social login) |
| **Order history** | Native, in the customer account portal |
| **Profile and addresses** | Native |
| **Theme styling** | The account button and its menu inherit the theme's colours and type |
| **Setup** | None — it works on a standard store |

> [!NOTE]
>
> This is deliberately *not* a custom login form. Building a custom account system
> means handling password resets, sessions, MFA and email verification yourself, and
> getting any of it wrong is a security incident. Shopify's accounts are free,
> hardened, and already there.

### The account menu

The button opens a menu with the standard destinations:

* Sign in / Register
* My account
* My orders
* Log out

The menu is keyboard accessible, closes on Escape and on outside click, and returns
focus to the trigger when it closes.

> [!WARNING]
>
> Do not build a second account system in a custom section. VARAHI's header button is
> wired to Shopify's accounts; a parallel login form will produce duplicate accounts
> and confused customers.

***

## Reviews

The Product Reviews section reads from product metafields rather than from a specific
app, so it works with any review app that writes to metafields.

### Metafields required

| Metafield | Type | Purpose |
| - | - | - |
| `reviews.rating` | Rating | Average score |
| `reviews.rating_count` | Number | Review count |
| `reviews.content` | Rich text | Review body |
| `reviews.author` | Single line text | Reviewer name |
| `reviews.created_at` | Date | Review date |
| `reviews.verified` | Boolean | Verified-buyer badge |

> [!NOTE]
>
> The **verified badge** only renders when `reviews.verified` is truthy. If your app
> uses a different key, the badge will not appear — this is the one metafield the
> theme is strict about, because a badge that appears on unverified reviews is
> misleading.

### How the section resolves which product to review

```text theme={"system"}
1. The current product (on a product page)
2. The "Product handle" setting (on the homepage)
3. The first product in the store (fallback)
```

> [!WARNING]
>
> That third fallback is convenient but it can surprise you. If you point the homepage
> reviews at a product and later delete it, the homepage will start reviewing a
> different product without telling you. Re-point the setting after any product
> deletion.

### What it renders

A rating summary — large score, star display, review count — followed by the
individual review cards, each with an author, date, verified badge and body.

The empty state is deliberate: a visible, honest empty state rather than a missing
section, because a missing section shifts the page layout.

***

## Trust, in one place

Both features feed the same goal: reduce the perceived risk of buying an expensive
product from a store the shopper has never heard of.

| Signal | Where it lives |
| - | - |
| "Sold out" / "In stock" pill | Hero Product, Main product |
| Scarcity meter | Hero Product, Main product |
| Shipping / warranty / returns strip | Hero Product trust row |
| Rating and review count | Main product, Product Reviews |
| Verified buyer badges | Product Reviews |
| Account portal with order history | Header |

> **[Product reviews](https://varaahi.vritservicespro.com/sections/product-reviews.md)**
>
> The section reference.

> **[Main product](https://varaahi.vritservicespro.com/sections/main-product.md)**
>
> The buy box, where most of these signals appear.


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