Tryit Virtual Try › Documentation

Tryit Virtual Try

AI-powered virtual try-on for WooCommerce. Let your customers see how products look on them — before they buy.

Version 1.0.0
WordPress 6.0+
WooCommerce 7.0+
PHP 7.4+

Key Features

Everything included in this plugin

  • One-click virtual try-on from any product page
  • Photo upload with drag-and-drop support
  • Webcam capture with live mirrored preview
  • Real-time AI processing with progress indicator
  • Download result image button
  • Async queue processing (no PHP timeout)
  • 3 AI providers: Replicate, FAL AI, Google Gemini
  • Result caching to reduce API costs
  • Per-product enable / disable control
  • Analytics dashboard with daily chart
  • HPOS (High-Performance Order Storage) compatible
  • Rate limiting to prevent API abuse

Requirements

Before you install

RequirementMinimumRecommended
WordPress6.06.8+
WooCommerce7.09.0+
PHP7.48.2+
MySQL5.78.0+
PHP ExtensionsGD or Imagick (for image resizing)
AI Provider AccountAt least one of: Replicate, FAL AI, or Google AI Studio

Installation

Get up and running in minutes

  1. Upload the Plugin In your WordPress admin go to Plugins → Add New → Upload Plugin. Select the tryit-virtual-try.zip file you downloaded from CodeCanyon and click Install Now.
  2. Activate Click Activate Plugin after installation. The plugin will automatically create its database tables and default settings.
  3. Configure an AI Provider Go to Virtual Try → AI Settings. Select your preferred AI provider and enter your API key. Click Test Connection to verify, then Save AI Settings.
  4. Enable on a Product Edit any WooCommerce product. In the right sidebar find the Virtual Try-On Settings panel. Check Enable Virtual Try-On, choose the product category, and save the product.
  5. Test on the Frontend Visit the product page on your store. The Virtual Try-On button will appear. Upload a photo or use your webcam to test the full flow.
💡
Manual Installation You can also unzip and upload the tryit-virtual-try folder via FTP to /wp-content/plugins/, then activate from the Plugins screen.

General Settings

Virtual Try → General

SettingDescriptionDefault
Enable Plugin Global on/off switch. When disabled, the try-on button is hidden on all product pages. Enabled
Button Label Text shown on the try-on button on product pages. Virtual Try-On
Button Color Try on button color can be changed. Virtual Try-On
Button Position Where the button appears on the product page: After Add to Cart, Before Add to Cart, or After Price. After Add to Cart
Max Image Dimension Images larger than this (px) are resized before being sent to the AI. Smaller = faster + cheaper. 1280
JPEG Quality Compression quality (40–100%). Higher = better quality, larger file size. 85%
Cache Results Save AI results so identical requests return instantly without a new API call. Enabled
Cache TTL How long (seconds) to keep cached results. 86400 = 24 hours. 86400
Enable Analytics Track try-on events and conversion data in the Analytics dashboard. Enabled

AI Settings

Virtual Try → AI Settings

Select your preferred AI provider and enter the corresponding API key. Use the Test Connection button to verify the key is valid before saving.

⚠️
Only one provider is active at a time. Select the provider radio button, enter the key, and save. You can store multiple keys and switch between providers at any time.
Replicate

Flexible model-based API. Uses IDM-VTON for virtual try-on. Best for developers who want to experiment with different models.

Synchronous

FAL AI

Queue-based async API. Uses the IDM-VTON model. Fastest turnaround time. Recommended for production stores.

Async Queue

Google Gemini

Uses Gemini 2.5 Flash image generation. Ideal if you already have a Google AI Studio account.

Synchronous

Product Setup

Enable try-on on individual products

  1. Open a Product Go to Products → All Products and edit the product you want to enable try-on for.
  2. Find the Settings Panel Look for the Virtual Try-On Settings panel in the right sidebar of the product editor.
  3. Enable Try-On Check the Enable Virtual Try-On checkbox.
  4. Select Category Choose the product category that best matches. This tells the AI what kind of try-on to perform.
  5. Save the Product Click Update. The try-on button will now appear on the product's frontend page.

Product Categories

CategoryBest For
Apparel / ClothingT-shirts, shirts, jackets, dresses, hoodies
EyewearGlasses, sunglasses, goggles
Shoes / FootwearSneakers, boots, sandals, heels
FurnitureSofas, chairs, tables (room placement)
Home DecorationLamps, rugs, wall art
AccessoriesHats, bags, jewellery, watches

Replicate

How to get and use your Replicate API token

  1. Create an AccountVisit replicate.com and sign up for a free account.
  2. Go to API TokensClick your avatar (top-right) → Account SettingsAPI tokens tab.
  3. Create a TokenClick Create token, give it a name (e.g. "WooCommerce"), and copy the token string.
  4. Paste in PluginIn Virtual Try → AI Settings select Replicate, paste the token and click Test Connection then Save.
ℹ️
Replicate charges per second of GPU compute time. Virtual try-on typically costs $0.01–$0.05 per request. New accounts receive free credits to get started.
ℹ️
Supports: T-shirts, shirts, blouses, Jackets, hoodies, coats, Jeans, trousers, shorts, skirts, Dresses, jumpsuits, suits

FAL AI

Async queue-based virtual try-on — fastest provider

  1. Create an AccountVisit fal.ai and sign up.
  2. Go to API KeysNavigate to Dashboard → Settings → API Keys.
  3. Create a KeyClick Add key, copy the key string.
  4. Paste in PluginSelect FAL AI in AI Settings, paste the key, test and save.

How Async Processing Works

FAL AI uses a queue system. Unlike other providers, requests do not block PHP execution:

1️⃣
Submit
Plugin submits job to FAL queue, gets a request_id instantly
2️⃣
Process
FAL AI processes the job (30–90 seconds). Browser polls every 3 seconds.
3️⃣
Result
When done, the result image is shown automatically. Max wait: 3 minutes.
ℹ️
Supports: T-shirts, shirts, blouses, Jackets, hoodies, coats, Jeans, trousers, shorts, skirts, Dresses, jumpsuits, suits

Google Gemini

Image generation via Google AI Studio

  1. Get a Free API KeyVisit aistudio.google.com/app/apikey and sign in with your Google account.
  2. Create API KeyClick Create API key, copy the key.
  3. Paste in PluginSelect Google Gemini in AI Settings, paste the key, test and save.
ℹ️
Model The plugin uses gemini-2.5-flash-image by default. You can change the model name in AI Settings if Google releases a newer image generation model.
ℹ️
Supports: All clothing types, Eyewear — glasses & sunglasses, Shoes & footwear,Caps, hats & head accessories,Bags, watches & jewellery, Furniture room placement, Home decoration

Analytics

Virtual Try → Analytics

MetricDescription
Try-Ons (30 days)Total completed virtual try-ons in the last 30 days.
Active ProductsNumber of products that had at least one try-on.
Conversion RatePercentage of try-on sessions that resulted in a purchase.
Avg Try-Ons / DayDaily average over the last 30 days.
Daily ChartLine chart showing try-ons per day across the full 30-day period.
Top ProductsProducts ranked by number of try-ons.
💡
Analytics are only recorded when Enable Analytics is turned on in General Settings. Events are tracked as tryon_completed in the wp_tryit_vt_analytics table.

Caching

How result caching works

When Cache Results is enabled, the plugin stores AI-generated images as WordPress transients. Identical requests (same photo + same product) return the cached image instantly with no API call.

Cache Key

The cache key is an MD5 hash of: person image data + product ID + AI provider slug. This means:

  • Same photo + same product = cache hit (instant result, no cost)
  • Different photo + same product = cache miss (new API call)
  • Same photo + different product = cache miss (new API call)

Storage

Results are stored in the wp_options table as WordPress transients (prefixed _transient_tryit_vt_). If you have Redis or Memcached configured, WordPress automatically uses those instead.

Clear Cache

To manually clear all cached results, run this SQL in phpMyAdmin:

-- Clear all Tryit Virtual Try cached results
DELETE FROM wp_options
WHERE option_name LIKE '_transient_tryit_vt_%'
   OR option_name LIKE '_transient_timeout_tryit_vt_%';

System Status

Virtual Try → System Status

The System Status page shows a real-time health check of your environment. Use it to diagnose problems before contacting support.

CheckWhat It Verifies
WordPress VersionMust be 6.0 or higher
WooCommerce ActiveWooCommerce plugin must be installed and active
PHP VersionMust be 7.4 or higher
GD ExtensionRequired for image resizing before API submission
cURL / HTTPRequired for outbound API calls
DB TablesVerifies wp_tryit_vt_sessions and wp_tryit_vt_analytics exist
Active ProviderShows the currently selected AI provider and whether it is configured
⚠️
DB Tables Missing? If the session or analytics tables are missing (can happen after migrations), click the Repair / Create Tables button on the System Status page. This safely recreates the tables without affecting existing data.

FAQ

Frequently asked questions

Which AI provider should I use?
For production stores, FAL AI is recommended — it's the fastest (async queue, no PHP timeout) and uses the purpose-built IDM-VTON model. Replicate is great for experimenting. Google Gemini is ideal if you already use Google AI Studio.
Does this work on mobile?
Yes. The try-on modal is fully responsive. Camera capture works on mobile browsers that support getUserMedia (Chrome, Safari iOS 15+, Firefox).
Are customer photos stored on my server?
No. Photos are sent directly from the server to the AI provider's API and are not stored on your server. Result image URLs (hosted by the provider) may be cached as WordPress transients for the duration of your Cache TTL setting.
Can I customise the button text?
Yes — go to Virtual Try → General Settings and change the Button Label field to any text you like.
The try-on button is not showing on the product page.
Check three things: (1) Plugin is enabled in General Settings. (2) The product has Enable Virtual Try-On checked in its settings panel. (3) The selected AI provider has a valid API key saved in AI Settings.
I'm getting a "Too many requests" error.
The plugin limits each user to 10 try-on requests per hour to prevent API abuse. Wait an hour or clear the rate limit transients from the database. Admin users are exempt from this limit.
How do I update the plugin?
Download the latest version from CodeCanyon, then go to Plugins → Add New → Upload Plugin and upload the new zip. WordPress will prompt you to replace the existing version. All settings and data are preserved.

Troubleshooting

Common issues and solutions

ErrorCauseFix
Fatal error: Class not found Autoloader failed or file missing Deactivate and reactivate the plugin. Ensure all plugin files were uploaded correctly.
DB table doesn't exist Tables weren't created on activation Go to System Status and click Repair / Create Tables.
API connection failed Wrong API key or provider outage Use the Test Connection button in AI Settings with your key. Check provider status page.
Request timed out PHP max_execution_time too low (for sync providers) Increase max_execution_time to 300 in php.ini, or switch to FAL AI (async, no timeout).
Could not fetch product image Product image URL not accessible by server Ensure product images are publicly accessible. Local/dev sites behind a firewall will cause this error.
Chart not showing in Analytics Chart.js CDN blocked or no data yet Check browser console for CDN errors. Ensure Enable Analytics is on and at least one try-on has completed.

Changelog

Version history

Version 1.0.0

Current March 2026
  • New Initial release with Replicate, FAL AI, and Google Gemini providers
  • New Async submit + poll pattern for FAL AI (no PHP timeout)
  • New Analytics dashboard with daily chart and top products
  • New Result caching via WordPress transients
  • New Per-product enable/disable and category selection
  • New Webcam capture with live preview
  • New Rate limiting (10 requests/hour per user)
  • New System Status page with DB table repair tool
  • New Configurable button label and position
  • New HPOS (High-Performance Order Storage) compatibility