View Markdown

Clothing AI Try-On — User Guide

This guide explains how to use the WEARFITS Clothing AI Try-On application. The experience is built around a personal digital twin: an AI-generated representation of your face and body that clothing items are virtually fitted onto. Once your twin exists it is reused across all sessions, so the setup cost is a one-time investment.

1. Quick Overview

The application follows a three-step process:

Create your Digital Twin — A one-time setup that generates your AI body representation from a face photo and either body measurements or a full-body photo.
Select Items — Browse the garment catalog and pick the clothing you want to try on.
Virtually Fit — The AI renders the selected items onto your twin and displays the result in various poses.

2. Creating Your Digital Twin

When the application opens for the first time, or after resetting a previous twin, you are guided through the profile creation flow.

Step 1: Face Capture

Grant camera permissions when prompted by the browser.
Align your face within the on-screen guide overlay.
Tap the Capture button when the face is correctly positioned.
Tip: Use a well-lit environment and avoid strong backlighting for the best facial match.

Step 2: Body Mode

You have two options for defining your body shape.

Option A: Size Mode (Default)

Size mode derives your body shape from standard garment size data. No photo is required. A twin created from this mode can also be used for estimated size fitting.

Field	Details
Gender	Select Male or Female
Height	Slider or direct input; range 140 cm – 210 cm
Clothing Size	XS, S, M, L, XL, 2XL, or 3XL

Body Measurements (when offered)

Some flows can use body measurements instead of a clothing size or a body photo. Enter at least two measurements in centimeters:

Measurement	Accepted input
Height	140–210 cm
Chest / bust	70–160 cm
Waist	55–170 cm
Hip	70–170 cm
Inseam	60–100 cm

These are validation limits, not a promise that the reference data contains every body shape in the range. WEARFITS matches the supplied values to the closest available reference body. If a value is inside the limits but outside the available reference data, it is accepted and extrapolated to the nearest match instead of being rejected, so the resulting shape remains an estimate. When a body-match response includes an out_of_range diagnostic, it identifies supplied values outside the searched population that were handled this way; it does not mean the request failed. Where the measurement flow asks for gender, supplying it narrows the matching population; a direct API request may omit gender, in which case both populations are searched.

Option B: Photo Mode

Photo mode uses a full-body image to compute a more precise body shape. When this option is available:

Upload a full-body photo taken from the front.
Stand straight with arms slightly away from the body — an A-pose or T-pose is ideal.
Ensure the entire body is visible from head to toe in the frame.
Use a plain or uncluttered background; avoid very loose or baggy clothing in the reference photo.

3. Virtual Fitting Room

Once your digital twin has been created, you enter the fitting room where you can browse items and generate try-on renders.

Category bar — Switch between Tops, Bottoms, and Full-length outfits using the navigation tabs at the top of the panel.
Pose selector — Change the standing pose of your twin (e.g., Default, Walking Pose) to evaluate how fabric drapes and moves.
Product panel — Browse available items in grid or list view on the side of the screen.

Trying On Clothes

Select an item — Click a product thumbnail to add it to your active selection. A Tops and a Bottoms item can be selected simultaneously to preview a complete outfit.
Combine items — Select a top and a bottom at the same time to try on a coordinated look.
Generate the fitting — Click the Try On button (bottom right corner). The button is active only when at least one item is selected and your digital twin has finished loading.
Wait for processing — The AI rendering takes a few moments. An indeterminate spinner is displayed while the fitting is being generated; WEARFITS does not show an estimated percentage or countdown. The app checks the job status automatically about once per second without overlapping checks, so you do not need to refresh. While you select garments, the app prepares the next verification check in the background. After your fitting request is accepted, it prepares another check while the fitting runs and the result loads, which can make returning to select another look faster.

Resetting or Editing Your Twin

To update your body data or reference photo, click the Profile or Back button in the top-left corner. This clears the current digital twin and restarts the profile creation flow from Step 1.

4. Estimated size fitting

Merchants setting this up follow Recommend a clothing size. It is not a shoe size.

On tryon.wearfits.com, size fitting is the clothing size estimate that belongs to this try-on. It compares a Size Mode digital twin with the product's body size chart and returns a recommended size. It is not a 3D body view and it does not draw a heatmap.

When it is available

Create the twin in Size Mode: a face photo plus body measurements, or height plus a clothing size (XS–3XL). A twin created from a full-body photo is not eligible, and the estimate is unavailable for that twin.

The estimate uses a body profile stored with the twin. The result does not include those measurements.

What you get

For each product that can be compared, the result names a recommended size and marks each compared measurement as fit, loose, or tight.

Fit — the body is inside the chart range for that measurement.
Loose — the body is below that range, so the size is roomier than the body.
Tight — the body is above that range, so the size is smaller than the body.

The reading is an estimate for that chart, not a promise of comfort. If the chart and the twin share no comparable measurement, that product is left out. If nothing can be compared, there is no estimate.

What the chart must contain

The chart is body ranges, not the garment's own measurements. Each size row needs a label and at least one shared measurement: chest or waist for tops, waist, hip, or inseam for bottoms, and chest, waist, hip, or height for full-length items. Units are centimeters or inches.

Stores that embed the try-on send this chart with the product. The same estimate is POST /api/v1/size-fitting on api.wearfits.com. Field-level rules are in the API reference.

5. 3D Shoe Try-On (AR)

The shoe section (accessible at /shoes or via the dedicated button) provides a separate AR-oriented pipeline for footwear.

Image upload — Upload up to four reference photos of the shoe from different angles.
Optional GLB mesh — Advanced users can drag and drop a .glb base mesh file to use as the 3D foundation for the shoe model.
Output — The pipeline produces a 3D model ready for AR visualization, viewable directly in the browser.

6. FAQ & Troubleshooting

Why is the "Try On" button disabled?

Two conditions must both be true before the button becomes active:

At least one clothing item must be selected in the fitting room.
Your digital twin must have finished generating — the twin is ready when your silhouette appears on screen.

Camera is not working

Open your browser's site settings and confirm that Camera is set to Allow for the current site.
On mobile, check that no other application is using the camera in the background.
If you are inside an embedded iframe, ensure the host page includes allow="camera" on the <iframe> element.

"Body Extraction Failed" error

This error occurs during Photo Mode processing when the body cannot be cleanly isolated from the image.

Make sure your entire body — from head to toe — is visible in the frame.
Use a plain, uncluttered background.
Avoid very loose or baggy clothing in the reference photo, as it can obscure the body outline.

7. Usage Limits

Limit	Value
Fittings per hour	10
Fittings per day	20
Twin storage duration	30 days (browser cookies)

Your digital twin is saved in your browser's cookies and automatically loaded on your next visit for up to 30 days. Clearing your browser cookies or cache will remove the saved twin and require you to recreate your profile.