wf_…), which is automatically loaded as a select option in your e-commerce plugin, or passed to the front-end Element as the workflowId.
The option is
workflowId, not ruleId. This is the most common integration mistake.The workflow stream: divided in two
To keep your storefront fast and prevent wasting server resources on unpaid carts, every workflow is split into two sequential phases by a trigger event:1. Intake (Client waits)
Runs while the customer is waiting on the product page. The assigned Upload Rule accepts the file, checks file type limits, and runs a Preflight Profile in milliseconds. This phase is optimized for speed; it only determines if the file is acceptable enough to proceed.
2. Processing (Triggered)
Runs after a trigger event fires (for example, once an order is placed). Since the client is no longer waiting, Filecheck can execute heavier asynchronous operations: automatically fixing files, downsampling images with Optimization Presets, splitting/merging pages, and bundling production-ready ZIPs.
Trigger events: bridging the two phases
The trigger is the gatekeeper that tells Filecheck when to move files from the intake phase to the processing phase.| Trigger Event | When Processing Starts… |
|---|---|
| Once uploads are accepted | Immediately after intake passes. Perfect for instant SaaS tools or live web tools. |
| After customer approves soft-proof | Once the customer reviews and signs off on their generated visual preview. |
| After an order is placed | When checkout completes (the standard choice for e-commerce, ensuring you only process paid orders). |
| Manually from Admin Jobs | Held in a queue until an administrator clicks Run from the Jobs dashboard. |
| Via API / webhook | Fired on demand when your custom external systems send an API request. |
Mapping workflows to products
Instead of editing raw code, Filecheck plugins for WooCommerce, Shopify, PrestaShop, and OpenCart handle this automatically:- Under your store’s general settings, you can assign a global Default Workflow from a dropdown list sync’d directly from your active Filecheck account.
- Edit any specific product to override that default and map a specialized workflow (e.g., assigning a Large Format Poster workflow to a poster product, and a Business Cards workflow to card products).
Building blocks
How Upload Rules, Profiles, Checks, and Presets fit together.
Build a workflow
Step-by-step setup guide in the dashboard.