FurniView documentation

FurniView lets your shoppers upload a photo of their own room and see your product placed into it by AI — right on the product page. This guide covers everything you can set up and do as a merchant.

What it does

• A “Try in your space” button appears on the product pages you enable.
• A shopper uploads a photo of their room, and the AI places your product into their photo — replacing the matching item if they already have one, otherwise inserting it naturally.
• The result keeps their room, lighting, and layout; only the product changes. Shoppers can regenerate, download, and rate it.

Everything is managed from the FurniView admin inside Shopify. Each store's products, uploads, and generated images are private to that store.

Quick start

Most stores are live in a couple of minutes.

1. Install FurniView from the Shopify App Store. You get 10 free generations to try it (a 7-day demo trial).
2. Add the widget to your theme: Online Store → Themes → Customize → on a product template, add the FurniView app block (or enable the app embed).
3. Sync your products from the app's Products page.
4. Configure a product: give it a category and a reference image, then set it Visible on store.
5. Test it on your storefront — open that product, tap Try in your space, upload a room photo, and generate.

What shoppers see

1. They tap Try in your space on a product page — a modal opens.
2. They upload or drag in a photo of their room (the whole photo is shown, portrait or landscape).
3. The AI generates in about 10–15 seconds and shows your product in their room.
4. They can Generate again, change the photo, download, go fullscreen, and give a 👍/👎 rating.

Guests can generate a limited number of times before being prompted to sign in — you control that (see Usage limits).

Plans

FurniView has three tiers. See the in-app Plans page for current pricing.

• Billing is handled through Shopify — charges appear on your Shopify invoice.
• When a trial or subscription ends, generation pauses until you subscribe again; your data and any purchased balance are kept.

Tokens & the Compute Fund

Each generation costs a small amount of AI compute, billed from your Compute Fund.

• Your subscription covers the app; generations are billed at cost from your token balance — FurniView doesn't mark up the compute.
• Buy credit bundles on the Tokens page. The full amount goes into your Compute Fund and never expires.
• The Fair Pricing breakdown on that page shows exactly where each dollar goes. If compute prices change, your remaining balance adjusts to the new rate.
• New installs get 10 free generations to start.

Products & enabling

The Products page is where you decide which products get the button and how the AI treats them.

Syncing

Click Sync with Store to import/update your catalogue from Shopify. Newly detected products stay hidden until synced and configured.

To make a product live, it needs two things

1. A category (required) — tells the AI what the product is (see Categories).
2. A reference image (required) — the picture of the product the AI places into the room.

Once both are set, switch Visibility to Visible on store.

Product attributes (optional, recommended)

Size, Material, and Color help the AI keep proportions and finish accurate. FurniView can auto-import these from your Shopify product data, or you can type them in.

Quick Edit vs. full page

Quick Edit (from the products list) covers everything — visibility, category, size/material/color, reference image, and per-variant images — without leaving the list. You can also select multiple products to enable/disable or set a category in bulk.

Reference images

The reference image is the product shot the AI places into the room. You have two sources:

• Shopify image — pick one of the product's existing Shopify images.
• Custom upload — upload a clean product shot, ideally on a plain background. Portrait phone photos are auto-rotated correctly.

Per-variant reference images

For products with color/style variants, you can give each variant its own reference image, so shoppers see the exact variant they're viewing.

• When a shopper generates on a specific variant, that variant's image is used.
• If a variant has no image, the product-level reference image is the fallback.
• Manage these in the product's Variants section — available in both the full product page and Quick Edit.

Categories

The category tells the AI which placement rules to use (a sofa replaces a sofa; a rug goes on the floor; wall art goes on the wall).

• FurniView ships a large set of specific categories — sofas, chairs, tables, beds, lighting, rugs, and many more.
• “Other” is a catch-all for products that don't fit a specific category; it uses the general placement logic. Because a category is required to enable a product, “Other” ensures nothing is ever stuck without one.
• If Shopify already has a matching product type, FurniView suggests it during sync — you can always change it.

Storefront widget

FurniView adds the button through Shopify's theme app extension — no code required.

1. Online Store → Themes → Customize.
2. Go to a product template.
3. Add the FurniView “Try in your space” block where you want it (usually near Add to Cart), or enable the app embed. Save.

The button only appears for products you've enabled, so it won't show on unconfigured ones. In the theme editor's design mode it's always visible so you can position it.

Appearance

On the Appearance page you control how the widget looks so it matches your brand:

• Button — text, background/text color, corner radius, size/height, width, font size, style (solid/outline), and an optional icon with its own color.
• Interface (modal) — header, description, and the accent button color/shape used inside the generation modal, plus the interface icon.

Changes are saved to your store and picked up by the storefront button automatically.

Usage limits

On the Usage Limits page you can cap how much generation happens and protect your compute:

• Daily limits — cap generations per day.
• Guest limits — how many times a not-signed-in shopper can generate before being prompted to sign in to continue. This controls cost and can convert browsers into registered customers.

Signed-in vs. guest usage is tracked separately and shown in analytics.

Notifications

The Notifications page and in-app toasts keep you informed — token low / critical / depleted warnings so you can top up before generations stop, plus other operational notices.

Dashboard

The Dashboard is your home screen. Everyone sees:

• Token balance and generations remaining.
• Monthly Generation Activity — completed generations per month this year.
• Setup guidance for getting live.

Advanced analytics Pro

Pro merchants get attribution and conversion insight:

• Sales after AI Generations — revenue attributed to shoppers who visualized a product, by week / month / year (the weekly view shows the current month broken down by week).
• Top products by generation count, with attributed sales.
• Conversion stats — add-to-cart and purchases after generating, guest→registered conversions, and the guest-vs-registered usage split.

Attribution is powered by a first-party storefront pixel that records add-to-cart and checkout events, matched back to recent generations of the same product.

How the AI works

• The AI treats the shopper's uploaded photo as the scene to keep and places your reference product into it — preserving their room, walls, and lighting, changing only the item being replaced or added.
• It prefers replacing an existing same-type item (their chair → your chair) and only inserts when there isn't one.

Best results come from

• A clean, well-lit reference image (plain background is ideal).
• An accurate category, and size/material/color filled in.
• Shoppers taking a straight, well-lit room photo (there's an on-screen tip for this).

Brand watermark Pro

Pro merchants can burn their own brand watermark onto generated images, with configurable position, size, and opacity — so shared visualizations carry your brand.

Data & privacy

• Isolation — each store's products, uploads, and generated images are private to that store.
• GDPR — FurniView implements Shopify's mandatory privacy webhooks (customers/data_request, customers/redact, shop/redact). On shop erasure, only anonymized image data (no store or customer identifiers) may be retained for model quality.
• Uninstall — removing the app stops the widget and pauses processing for your store.

Troubleshooting & FAQ

The button doesn't show on my storefront.

Check that (a) the product is Visible on store with a category and reference image, and (b) the FurniView app block/embed is added to your product template in the theme editor.

A shopper got “generation limit reached”.

That's your guest limit — they can sign in to continue, or you can raise the limit on the Usage Limits page.

Generation failed / “payment required”.

Your plan may have expired, or your token balance / free generations are used up. Check Plans and Tokens.

The result looks like the product's studio photo, not my shopper's room.

Use a clean product reference image and make sure the category is set. A busy or full-scene reference makes it harder for the AI to keep the shopper's room.

Portrait photos look sideways.

Uploads are auto-oriented from their EXIF data before processing, so this shouldn't happen — if it does, re-upload the photo.