Setup & API guide
Tryveliq makes your verified baby and child body-size charts interactive on Shopify product pages. Parents enter current measurements without uploading a child photo. Start with a verified guide; styling images are optional.
1. Connect and choose a plan
Open Tryveliq from Shopify Apps. Choose a paid plan and approve it on Shopify’s pricing page. The app checks the confirmed subscription before enabling the catalog, studio and API. If you return without approving, access stays locked. Eligible monthly and yearly Shopify subscriptions include a 3-day trial after approval; Shopify shows any remaining trial days and exact charge. There is no ongoing free plan.
2. Choose a product and verify its guide
Shopify products synchronize automatically after a plan is approved; Sync Shopify explicitly refreshes the catalog. In Products → Manage, choose baby or child and the correct garment category. Record the brand measurement source and verification date. Enter BODY ranges in centimeters, not flat garment widths. Variant labels alone do not supply these ranges. A size guide needs no garment image, avatar or generated preview.
3. Match the dimensions to the product
Supported ranges include height/body length, chest, waist, hip, inseam, head circumference and foot length. Baby guides explain lying body length; hats require head ranges and footwear requires foot ranges. Use the brand’s category-specific chart, not age/weight guesses or outsole length. Brand sizing may already include growth or diaper space. Reuse a verified guide only on explicitly selected compatible products; it is not applied to the whole catalog automatically.
4. Add the storefront block
- Save a verified guide on a synced Shopify product in Products → Manage. An approved styling preview is optional. Manually created API products are not linked to Shopify product pages.
- Open Online Store → Themes → Customize and select the product template used by your prepared product.
- Choose Add block → Apps → Tryveliq fitting room. If the section does not support app blocks, choose Add section → Apps. An Online Store 2.0 theme with app-block support is required.
- Select the prepared product in the theme preview, adjust the block position and optional per-language button labels, then save. The guide follows the storefront language: English, German, French or Turkish, with English fallback for other languages. Open the product-page guide and try its example, then replace sample values with current measurements.
Knowledge and Settings in the app include a shortcut that adds an unsaved block in the current theme. Edit an existing Tryveliq block instead of adding a duplicate. Keep Show photo-free guides and approved previews enabled in Settings. If the subscription is inactive, the setting is off, or the product has no approved preview or chart, the button stays hidden.
To remove the button, remove the Tryveliq block in the theme editor and save. To hide all previews and charts, turn off Show photo-free guides and approved previews in app Settings.
5. Test the parent’s photo-free workflow
Use body-measurement ranges from your own size chart, in centimeters. These are body ranges, not the flat width of the garment. The storefront compares shopper entries locally without sending measurements to Tryveliq. The result is chart-based guidance, not a fit guarantee.
Photo-free assistant
- Choose “Try an example” to understand the interface without measuring a child.
- Enter only the measurements requested. Open a field’s “i” button for the measuring diagram. “Edit measurements” clears an example before real entry; real measurements are retained when editing.
- Complete the required fields and choose “Find a size” for the separate result step. Missing, invalid, overlapping or outside-chart entries show an explanation.
- Open “Advanced options” for units, language, profiles and “Compare two sizes”. Sold-out sizes do not have a purchase link. The guide never adds a product to the cart automatically.
The initial screen contains measurements, a single main action and an illustrative baby or child avatar. Choose “Open 3D avatar” to load a real, rotatable and zoomable 3D model. Valid entered measurements change its proportions locally; unmeasured proportions use generic defaults. The clothes are generic, not this product’s digital pattern, body scan or fabric simulation. Use “Hide 3D” to collapse it. If WebGL is unavailable, the size guide still works and offers a retry. Shoppers can use “i” help, open advanced settings to switch centimeters/inches, and compare any two configured sizes with exact per-dimension differences. Comparison uses BODY ranges, not garment ease; it never recommends an unavailable replacement or predicts child growth. A source-approved growth mapping is required for the existing growth preference.
An adult or guardian may explicitly save up to three anonymous measurement slots in this browser tab for up to 24 hours, reuse them on other products at this shop, and delete all saved slots. No photo, name, age or shopper account is needed. Examples cannot be saved. Closing clears current inputs; saved slots are opt-in. The optional styling image is not a fit simulation.
Merchant readiness and usage
Dashboard → Photo-free fit insights shows actual guide sizes and 30-day, consent-based per-product event counts. Export displayed rows to CSV. Example checks are excluded. Counts are not unique shoppers, purchases, conversion rates or saved returns. Settings controls collection, which also requires shopper analytics consent. Products can be filtered by missing or configured measurement guides. Reuse a guide only on explicitly selected compatible products.
Optional: a reviewed styling illustration
In Styling previews, prepare a garment image and a licensed, fully clothed model or avatar appropriate to the product’s age group. Generate a preview, check the actual print, seams, color and proportions, and publish only an accurate result. Nothing is published automatically. A failed generation does not consume the monthly allowance. A static illustration does not change with measurements, simulate fabric fit or replace a verified guide.
See the current step-by-step screen overview.
API quick start
Create a workspace API key in the paid app’s API page. The key is shown
once. Keep it in your backend environment. Base URL:
https://tryveliq.hakan-olcer.workers.dev/v1.
curl "$TRYVELIQ_URL/v1/products" \
-H "Authorization: Bearer $TRYVELIQ_API_KEY"
Set TRYVELIQ_URL=https://tryveliq.hakan-olcer.workers.dev.
The key must belong to a workspace with an active verified subscription.
| Endpoint | Purpose |
|---|---|
| GET /products | List workspace products |
| POST /products | Create a product |
| PATCH /products/{id} | Attach a garment asset and size chart |
| POST /assets?kind=avatar&name=Model | Upload raw PNG/JPEG bytes |
| POST /generations | Queue a preview |
| GET /generations/{id} | Poll status and obtain a temporary result URL |
| POST /recommendations | Compare measurements with a supplied chart |
Upload requirements
PNG/JPEG only, 32–512 pixels per side, maximum 2 MB. Set the correct
Content-Type and X-Image-Rights-Confirmed: true. Use
kind=garment or kind=avatar. Binary uploads
are raw bytes, not JSON or multipart.
Start a generation
curl "$TRYVELIQ_URL/v1/generations" \
-H "Authorization: Bearer $TRYVELIQ_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: your-unique-request-id" \
-d '{"productId":"PRODUCT_ID","avatarId":"AVATAR_ASSET_ID"}'
Poll the returned job ID. Statuses are queued,
running, completed and failed.
Result URLs expire after ten minutes; request a fresh one by reading the
job again. Use the dashboard to publish results; an API key cannot
manage billing, publish previews or create other keys.
Limits and errors
Workspace requests are limited to 120 per minute. Generation allowances depend on the plan and are shared with the dashboard. The monthly allowance resets on the first UTC day of the month. Responses use 401 for invalid authentication, 402 for a required subscription, 403 for insufficient permissions, 429 for limits and 503 when billing verification is temporarily unavailable. The API fails closed if it cannot verify paid access.