> For the complete documentation index, see [llms.txt](https://sitesbyseth.gitbook.io/sitesbyseth-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sitesbyseth.gitbook.io/sitesbyseth-docs/skeleton/faq.md).

# FAQ

Quick answers to the questions we hear most. Each one is based on how the theme actually behaves.

## My product images look cropped on collection pages

Product cards crop photos to fill a fixed shape (so the grid stays tidy). Two fixes in **Theme settings → Product cards**:

1. Change **Image aspect ratio** to match how your photos were shot — Portrait (4:5) or Tall (2:3) for on-model shots, Square for flat lays.
2. Or set **Image fit** to **Shrink to fit (no crop)** — the whole photo always shows, with space around it.

For the product page gallery, the equivalent setting is **Media aspect ratio** on the Product page section — pick **Natural (no crop)** to show images at their own shape.

## The size finder shows "No matching size found"

The finder's chart is empty or misformatted. Go to **Theme settings → Size finder → Size chart (measurement limits)** and check every line has exactly three comma-separated values — size, max height (cm), max weight (kg) — like `M,178,80`, smallest size first, `999` for open-ended limits on the largest size. See the [size finder deep dive](/sitesbyseth-docs/skeleton/size-finder.md).

## The size finder recommends sizes this product doesn't have

It shouldn't — the recommendation snaps to the sizes in the product's **Size** option. If it seems off, check that your product's option is actually named "Size" (the finder looks for an option whose name contains "size") and that the chart's size names match your variant names (S/M/L vs. Small/Medium — common spellings are recognized, but custom names like "OS-2" aren't).

## The "View size chart" button doesn't appear

The button only shows when there's a chart to show: either a global image/page under **Theme settings → Size finder**, or a per-product image in the product's `custom.size_chart` metafield. Products with neither don't get the button. Setup steps in the [deep dive](/sitesbyseth-docs/skeleton/size-finder.md).

## The free gift isn't free at checkout

⚠️ This is the most important one: the theme adds the gift to the cart but **cannot change its price**. The gift product must be priced **$0.00** in your catalog (**Products → the gift product → Price**). Until it is, customers are charged the real price — and the cart deliberately shows the real price instead of "FREE" so nobody is misled. Full guide: [Free gift setup](/sitesbyseth-docs/skeleton/size-finder/free-gift.md).

## The free gift never gets added

Check, in order: the **Free gift** block exists on the **Cart drawer** section and **Enable free gift** is on; at least one gift product (or a gift collection) is selected; the gift product is **in stock**; and the cart's subtotal *excluding the gift* actually reaches the threshold. Also note: if you removed the gift from the cart yourself while testing, it stays removed until spend drops below the threshold and crosses it again — clear the cart and retest.

## My hero video isn't playing

Upload the video file through the section's **Video** setting (it must be a file in Shopify, not a YouTube link, for the Image banner and Password page backgrounds). Background videos play muted on a loop automatically — if you see the image instead, the video setting is empty; if you see neither, re-upload the file under **Content → Files** and select it again. Keep files small (a compressed 10–20 second loop); huge files can be slow to start on mobile connections.

## My menu isn't showing / shows the wrong links

The header displays the menu chosen in its **Menu** setting (default: "Main menu"). Edit the links under **Online Store → Navigation** in your admin — click the menu, add or reorder items, save. If the header shows nothing, the selected menu has no links yet. Dropdown sub-items appear in the slide-out menu drawer (the burger icon).

## How do I change the fonts?

**Theme settings → Typography → Font style**: **Monospace** (the signature Courier-style look) or **Sans-serif** (Helvetica-style). Those are the two options — the theme uses fast system fonts rather than a font library. You can also tune **Base font size** and **Letter spacing** there.

## How do I change the orange color?

**Theme settings → Colors → Accent**. It drives the add-to-cart and checkout buttons, sale prices, and highlights. If you pick a light accent, also set **Text on accent** to black so button text stays readable.

## The header disappears when I scroll

That's the **Show when scrolling up** sticky mode — the header hides while scrolling down and returns when you scroll up. Change it under the Header section's **Sticky header** setting: **Always visible** keeps it pinned; **Not sticky** lets it scroll away for good.

## Quick view (+) buttons aren't on my product cards

Turn on **Theme settings → Product cards → Enable quick view (+) button**. Note the + only appears on products that are in stock — sold-out products don't get one.

## Where do newsletter and waitlist signups go?

Into your Shopify admin under **Customers** — footer/newsletter signups are tagged `newsletter`, and password-page signups are tagged `prospect, password page`. Email tools (Shopify Email, Klaviyo, Mailchimp) can target those tags. SMS signups on the password page go directly to the SMS provider whose form URL you configured.

## Contact form messages aren't reaching me

Submissions are emailed to your store's **sender email** — check it under **Settings → Notifications** in your Shopify admin, and look in spam the first time. The theme doesn't store messages anywhere.

## Why don't my collection pages show filters?

Filters come from Shopify's free **Search & Discovery** app. Go to **Online Store → Navigation → Collection and search filters** and add the filters you want (size, price, availability…). Also confirm **Enable filtering** is on in the Collection page section. The theme can only display filters that exist.

## The countdown shows different times for different people

By design: countdowns (header block and password page) run in each **visitor's local time zone** — `2026-08-01 18:00` hits zero at 6 PM wherever the visitor is. It makes "drops at 6PM your time" effortless; if you want one global moment instead, state the time zone in your marketing copy and set the countdown to your primary market's time.

## How do I get theme updates?

Two ways: re-download the zip from your purchase email and upload it as a new theme, or request the GitHub connection for automatic in-place updates (recommended once you've customized). Details and trade-offs: [Theme updates](/sitesbyseth-docs/skeleton/size-finder/updates.md).


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://sitesbyseth.gitbook.io/sitesbyseth-docs/skeleton/faq.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
