Tiktok
The TikTok app connects your ShopWired account to TikTok Shop, enabling automated product sync, order importing, real-time stock management, and conversion tracking. This guide explains each feature, how to configure the app, and how to resolve common issues.
Please note that TikTok applies the following limits:
- New individual sellers are limited to 100 orders per day
- New corporate sellers are limited to 200 orders per day
- All new sellers are limited to 100 product uploads per day
Once sellers graduate from probation, sellers are not subject to order limits but are limited to 1,000 product uploads per day. These limits are imposed by TikTok, please see here for more information.
To install the app:
Once the app is installed, configure your TikTok settings by navigating to Apps > Manage > TikTok.
Connecting to TikTok Shop
Connecting to TikTok Shop
Connect your ShopWired account to TikTok Shop using OAuth authorisation.
- The app displays the connection status at the top of the page.
- Select
Disconnect from TikTokto immediately disable all product sync and order import functionality. - When you reconnect, your configuration is restored automatically.
App Settings
App Settings
Configure how products and orders are managed between ShopWired and TikTok Shop.
List variants as separate TikTok products
When enabled, each product variant is sent as a separate TikTok product with its own title. The default is No. Changes only affect products exported after the setting is changed. A notice is displayed when the setting is changed.
Automatic product sync
Enables automatic synchronisation of all eligible products whenever they are created, updated, or set to active in ShopWired.
- When turned on, a
Sync nowbutton appears, allowing a one-off export of all products not yet exported to TikTok. - The
Sync nowbutton disappears when the sync completes, but will reappear if automatic sync is turned off and on again. - Manual send options are hidden when this is enabled.
Enable manual send
Allows manual export of products via a Send now button for each product in the Products table. This setting is only visible if Automatic product sync is off.
Order importing
Automatically imports TikTok Shop orders into ShopWired’s orders page. If disabled, orders will only appear in the app’s Orders section.
Stock import from TikTok orders
If order importing is off, this setting allows TikTok orders to deduct stock from ShopWired inventory without importing the order itself.
Nightly stock sync check
Runs a nightly check (2:00am UK time) to reconcile ShopWired and TikTok stock levels, correcting mismatches automatically.
Select View logs to see a full record of stock checks and corrections.
Order status sync from TikTok to ShopWired
Enables updating ShopWired order status when an imported order’s status changes on TikTok.
Default shipping rate
Select the shipping rate to apply to imported TikTok orders.
TikTok Mappings
TikTok Mappings
Map ShopWired categories, brands, and order statuses to TikTok’s requirements.
Default TikTok Category
Used when no category mapping exists.
ShopWired Category > TikTok Category
Map each ShopWired category to a TikTok category (only leaf categories are valid).
ShopWired Brand > TikTok Brand
Map ShopWired brands to TikTok brands.
If no mapping exists, TikTok will assign “No Brand” where permitted.
TikTok Order Status > ShopWired Order Status
Map TikTok order statuses to ShopWired order statuses.
ShopWired Products
ShopWired Products
Displays all ShopWired products and their sync status with TikTok.
| Product Image | Product Name | SKU | TikTok Sync Status | TikTok Short URL | Manual Send | Logs |
|---|---|---|---|---|---|---|
| Image | Name | SKU | Sent/Not Sent/Failed | /tiktok-xxxxxx + copy button | Send now (if enabled) |
View log |
- Use the search bar to find products by name or SKU.
- Select checkboxes to send multiple products in batch.
- Pagination: 50 products per page.
- TikTok Short URLs are generated for use in TikTok content and ads.
Product images
Product images
TikTok applies strict requirements to product images. If these requirements are not met, products will fail to export or be rejected during approval.
Image aspect ratio
The main product image must have an aspect ratio between 3:4 and 4:3.
- Minimum ratio: 0.75 (portrait)
- Maximum ratio: 1.333 (landscape)
- Square images (1:1) are fully supported and recommended
Image size and format
- Minimum size: 600 × 600 pixels
- Recommended size: 1000 × 1000 pixels or larger
- Supported formats: JPG, JPEG, PNG
How ShopWired handles images
ShopWired sends product images to TikTok exactly as they are stored in your account.
- Images are not automatically cropped, resized, or adjusted
- If an image does not meet TikTok’s requirements, the product export will fail
Exports
Exports
Shows all products exported to TikTok, approval status, and rejection reasons.
| Product Name | Sync Date (GMT) | TikTok Status | Disapproval Reasons | Delete | Logs |
|---|---|---|---|---|---|
| Name | Date & Time | Approved/Disapproved | Reason from TikTok | Delete | View log |
- Use checkboxes to batch delete products from TikTok (does not delete from ShopWired).
- Exported products can be re-exported after deletion.
Orders
Orders
Lists all TikTok Shop orders with full status and log details.
| Order ID | ShopWired Status | Customer Name | Order Date (GMT) | Order Total | Fulfilment Status | API Received | API Sent | Logs |
|---|
- Filter by TikTok order status (e.g. Awaiting Shipment, Delivered, Completed).
- The ShopWired Status column shows whether the order was imported.
- Orders imported to ShopWired appear in both the app and your main ShopWired orders page.
- Orders not imported appear only in the app.
TikTok Events API
TikTok Events API
Enables server-side event tracking for TikTok Ads (similar to Facebook Conversions API).
Enable TikTok Events API
Toggle integration on/off.
Access token
Enter your TikTok API access token.
TikTok Pixel
Select the TikTok Pixel to send event data to.
Enable debug logging
Logs all event requests and responses.
Exported Events Table:
| Order ID | Event Time (GMT) | Pixel ID | Trace ID | Status | Event JSON | Logs |
|---|
Event Errors Table:
| Order ID | Attempt Time (GMT) | Error | Event JSON | Logs |
|---|
Custom Fields for TikTok Product Data
Custom Fields for TikTok Product Data
To meet TikTok’s data requirements, set these custom fields on your products:
- TikTok Length: Length value (numeric, required for some categories)
- TikTok Width: Width value (numeric, required for some categories)
- TikTok Height: Height value (numeric, required for some categories)
- TikTok Unit: Choice: CENTIMETER or INCH (required for some categories)
- TikTok Video: Optional direct URL to .mp4 file (publicly accessible)
Data Mapping
Data Mapping
ShopWired fields are mapped to TikTok as follows:
| TikTok Field | ShopWired Field |
|---|---|
| product_name | Product title |
| description | Product description |
| product_id | Product ID |
| sku_code | SKU |
| price | Price |
| discount_price | Sale price |
| quantity | Stock |
| product_weight | Weight |
| images | Product images |
| main_image | Main image |
| brand_id | Brand (mapped) |
| category_id | Category (mapped) |
| gtin/mpn | GTIN/MPN |
| video_url | TikTok Video custom field |
By default, variations are sent as a single TikTok product with specs and SKUs unless List variants as separate TikTok products is enabled.
