> 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/showcase/faq.md). # FAQ Quick answers to the questions we hear most. Each one links to the full guide when there's more to know. ### Why can't I add sections to the homepage? By design. Showcase's homepage renders exactly two sections — **Product stories** and **Lookbook** — so the story deck stays a pure, full-screen experience. Both are fully configurable (blocks, backgrounds, hotspots); you just can't insert other sections between them. Put banners, rich text, and grids on regular pages instead. See [Building the homepage](/sitesbyseth-docs/showcase/getting-started/homepage.md). ### A story screen shows a gray placeholder instead of a product. Why? That Story block has no product selected. Click the block in the editor and pick one in the **Product** field. Placeholders say "Select a product for this screen in the theme editor" and never show real buttons — they're a you-facing reminder, but don't publish with one live. ### My background video isn't playing. What do I check? 1. Confirm it's uploaded in the block's **Background video** picker (a background *image* set at the same time is only a fallback — the video wins when present, so if you see the image, the video didn't load). 2. Give it a moment on slow connections — the panel's background color shows first and media fades in when ready. 3. Remember Showcase only plays the video of the **currently visible screen** — hidden deck panels keep their videos paused on purpose. That's performance, not a bug. 4. Keep files small (short loops, compressed). Very large videos can take long enough to load that visitors scroll past first. ### Why does scrolling fade between products instead of moving the page? That's **fade mode**, the signature transition — the screen holds still and products crossfade as you scroll. If you want conventional scrolling, set **Product transition** to `Scroll` in the Product stories (or Collection page) section. Also note fade needs at least two products; a one-block deck won't fade. ### Auto-cutout is on but my product photos still have backgrounds. The cutout only fires on photos whose **four corners are the same flat color** (a studio backdrop). Lifestyle shots, gradients, corner shadows, and products touching the edge make the theme skip the image on purpose. Check the corners after the 4:5 center crop, re-shoot on a seamless backdrop, or crop with more margin. Full checklist: [Auto-cutout](/sitesbyseth-docs/showcase/auto-cutout.md). ### My customer was charged for the "free" gift! The gift product isn't priced **$0**. The theme adds the gift to the cart but **cannot change prices** — it shows the product's real price rather than pretending. Edit the gift product and set its price to 0 (or cover it with an automatic discount). Everything else fixes itself. Details: [Free gift](/sitesbyseth-docs/showcase/free-gift.md). ### The free-gift milestone isn't showing on the cart progress bar. Four things must all be true: the **Milestone bar block** is added to the Cart drawer section with **Show free gift milestone** on; the gift is **enabled** in Theme settings → Free gift; the gift product is **in stock**; and the unlock rule includes a **spend amount above 0** (a gift that unlocks *only* by qualifying products has no spend threshold to mark on a bar). ### I tapped Buy now but no offer window appeared. The offer window only opens when the attached offer product **has options** (like sizes) — the buyer needs to pick one. A single-variant offer is added silently and the button itself says "Buy now — \[offer]". Also check an **Offer product is actually attached** in that block's Buy now settings and that it's **in stock** — a sold-out offer disables itself. ### Where did my Lookbook go? Either **Show lookbook** is unticked, or all its **Look blocks** were deleted — both hide the section completely, including its chip on the side rail. Re-tick the setting and/or add a Look block with an image. See [Lookbook](/sitesbyseth-docs/showcase/sections/lookbook.md). ### "Find my size" isn't showing on one of my products. The finder appears automatically on products Showcase recognizes as clothing: apparel words in the **product type** or **tags**, or an option named **Size** (*Größe*/*Taille* count too). Add a tag like `hoodie` or rename the option to "Size" and the link appears. See [Size finder](/sitesbyseth-docs/showcase/size-finder.md). ### Why doesn't the rail have a "Home" chip on my homepage? The Home chip only appears when other content sits **above** the story section — it exists to scroll back past that content. On the standard homepage the deck *is* the top, so the first product is chip 01 and there's nothing to go home to. ### The product gallery crops my photos. Can I change the shape? Story-screen galleries crop every image to the same **4:5 portrait frame** (center-cropped, server-side) so the deck looks identical across products and devices. You can't change the ratio — instead, shoot or crop with the product centered and margin around it, and the crop will never clip anything important. ### Can I show more than 5 images per product? On story screens, no — the slideshow shows the first **5 media items**, keeping full-screen panels fast. Put your best five first (drag to reorder in the product admin). Product videos count and play in place; external videos and 3D models appear as preview stills. ### My checkout button in the cart is grayed out. You've enabled **Require agreement before checkout** in the Cart drawer section — the button unlocks when the buyer ticks the agreement checkbox. If you don't want that step, untick the setting (or clear the agreement text). ### Do visitors on phones get the same experience? Yes — the deck, fade transition, rail, slideshows (swipe-enabled), size finder, and cart drawer are all built mobile-first. Visitors who've turned on "reduce motion" on their device get instant jumps instead of animated warp-scrolls, automatically. ### How do I update the theme without losing my work? Depends how you installed. **GitHub-connected:** updates flow in automatically and your settings survive. **Zip:** a new upload is a separate copy, and you re-apply settings on it before publishing. Full guide: [Updates](/sitesbyseth-docs/showcase/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/showcase/faq.md?ask=&goal= ``` `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.