Everything you need to install, configure, and get the most out of suPixel AI Try On.
suPixel AI Try On is a standard WordPress plugin. Download the .zip file and install via Plugins → Add New → Upload Plugin in your WordPress admin.
All settings are found under suPixel → Settings in your WordPress admin.
| Setting | Description | Default |
|---|---|---|
| Button Text | Label shown on the product page button | "Try It On" |
| Button Colour | Background colour (hex) | #6AADA8 |
| Button Position | Before or after the add-to-cart button | After |
| Border Radius | Corner rounding in pixels | 0 |
| Toggle | Description |
|---|---|
| Session Gallery | Save results in localStorage for 24 hours |
| Sharing | Show WhatsApp, download, and share buttons on results |
| Watermark | Show suPixel watermark on result images (forced on Free plan) |
| Studio Mode | Show Studio/Try-On toggle (paid plans only) |
| Privacy Consent | Show GDPR consent screen before photo upload |
suPixel supports 27 product categories, each with a specialised AI prompt. The plugin auto-detects the category from your WooCommerce product taxonomy, or you can set it manually per product.
| Group | Categories |
|---|---|
| Fashion | tops, bottoms, dresses, outerwear, shoes |
| Accessories | watches, nails, hair, jewellery, eyewear, accessories |
| Automotive | wheels, car_parts, car_wraps, number_plates |
| Home | doors, windows, furniture, flooring, wallpaper, lighting, curtains |
| Tech | phone_cases, laptop_skins |
| General | general (fallback) |
Studio Mode creates professional editorial portraits instead of editing the original photo. Available on paid plans (Starter, Growth, Pro, Enterprise). Costs 2 credits per generation.
Studio Mode uses professional studio lighting (key + rim + fill), an 85mm lens feel with shallow depth of field, and luxury fashion colour grading.
Photos go directly from the customer's browser to api.supixel.ai using HMAC-SHA256 signed tokens. This bypasses your server, WAF, and file size limits.
If the direct upload fails (CORS issue, network error), the plugin automatically falls back to the server-side admin-ajax.php route.
When enabled, results are saved in the customer's browser (localStorage) for 24 hours. A thumbnail strip below the result lets customers browse previous try-ons without re-generating.
Result images can be shared via WhatsApp, native mobile sharing (navigator.share), copied to clipboard, or downloaded directly. All sharing text is translated into the active language.
The plugin includes 7 translations: English, Turkish, Arabic (with RTL), German, Spanish, French, Italian, and Dutch. Every UI string is translatable — modal buttons, consent text, loading states, error messages, and share messages.
The suPixel cloud API is at https://api.supixel.ai/v1. Pro plan subscribers get REST API access for custom integrations.
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/health | Health check |
GET | /v1/credits/balance | Get credit balance |
POST | /v1/try-on/generate | Generate try-on image |
POST | /v1/licence/register | Register new free licence |
POST | /v1/licence/validate | Validate licence key |
POST | /v1/checkout/session | Create Stripe checkout |
API requests use Authorization: Bearer <licence_key>. The generate endpoint also accepts HMAC-SHA256 signed tokens for browser-direct uploads.
Ensure WooCommerce is active and the plugin is activated. Check that your product has an image. The button only appears on single product pages.
Check your credit balance in suPixel → Dashboard. If credits are available, check your server's PHP error log for AJAX errors. The plugin will fall back to server-side upload if direct upload fails.
The direct upload requires CORS headers from api.supixel.ai. If you see CORS errors, the plugin automatically falls back to the server-side route. Contact support if the fallback also fails.