User Manual Quickstart Video Tutorials General Concepts Buyer Side Buyer Side Appearance Settings Sticker Snippets Layout Snippets Engraving Styles and Form Fields Flex Designs Sub Documents Scripting Workflows Template Types Frame Features Resources Account Portal Style Reference Integrations Woo Commerce Lets start installing Variable Products Shopify Bubble Hp Site Flow 3D Api Reference Authorization Tokens Embedding The Editor Custom Integration Backend Api Price Display Glossary Changelog Bugs Limitations Acknowlegements

WooCommerce Plugin

How to Install and Configure the Printess WooCommerce plugin

Please have a look at our example woocommerce shop using this plugin.

Lets start installing

Download our WooCommerce plugin:

Copy the content of the zip file to the plugins folder so that the php file has the following path: wp-content/plugins/printess/printess.php), then you can activate it manually in the WordPress plugins.

Install the plugin

After activating it, a menu item “Printess” appears at the very end of the WooCommerce section. There you must make a few settings.

Plugin settings

Important are the two Printess access tokens (Shop-token and Service-token) that you can find in the editor at API Tokens in the top right account menu or on the account page, which you can reach via a link (

Printess token

Please also fill Api-Domain (by default and Embed-Html (by default You can also address specific versions of the editor e.g. by choosing and

In IDs to hide when showing the editor you must name every element id from your WooCommerce theme which needs to get hidden (otherwise it will show in front of the editor). Please make sure that nothing is left. The Printess editor needs to be fullscreen especially for mobile use.

Additional classes for customize buttons you need to name all classes of add to cart buttons which should get a customize button for Printess products.

You can set Order Approval Mode to “Manual” for now - this will not send the Printess products to the API for production immediately and you can approve it manually. Setting it to “Auto” will automatically sent jobs to the Printess API when the shop order is created.

How can you create a Printess product? Create a new “Simple Product”. In the item settings you will find a “Printess” tab. Of course also existing simple products can easily become Printess products.

Create product

In the Printess tab you can search for published Printess templates or enter them manually. Additionally its possible to configure up to 3 merge templates. Leasrn more about merge templates here.

Create Printess product

After setting up template and eventual merges update/publish as usual via “Update”.

Publish product

Done! Now it is a Printess product. Therefore the product page has changed:

Product page

The “Add to Cart” button is gone, but there is a new “Customize” button. The first thing a customer needds to do is to customise the product. The Printess editor should open like below.

Customise Product

Once configured the customer can press the add to cart button. The customised product will be added to the cart and show its configuration with a small cart image.

Product in cart

From here it can be edited again by selecting the ‘Edit’ link and add it to the cart again. In this case the new version will shown additionally in the cart.

Once the order is finished, you can see its details in the order view. As Manual release mode is set in our example shop each order element must now be approved manually, by clicking “Approve and send to production”.

Product in cart

After some time, the production result(s) will show as a link to download the pdfs.

In case a customer order needs to be changed - you can do so by selecting ‘Edit Customer Order’.

If there is any error during production, it will also appear here.

If you have any additional questions or got stuck anywhere please contact us at we are happy to help!

Variable Products

The Printess Woo-Commerce PlugIn supports variable products (product variants). Your Printess templates must have select- or image-list type Form Fields with the Price Relevant Switch in the Form Field properties enabled. For testing use our Retro Sign example document which has the Material and DOCUMENT_SIZE Form Field configured like this.

Variant generation will be done automatically based on the possible Form Field values. Note that every combination of all price relevant Form Field values will create one variant so the Woo-Commerce limit of variants (currently 50) is reached fast when you have several Form Fields.

To create a variable Printess product in WooCommerce, follow these steps:

The Printess Woo-Commerce PlugIn supports initialization of the Editor with the Form Field values selected on the product page. It also supports mapping back changes in the form fields to the shop.

You can control if you’d like to have variant selection in the Printess editor by switching the Form Fields visibility property between Buyer Side and Design Side.

Here is a video of the above tutorial (a template with the Name Retro Sign had been created and published on the account based on the Retro Sign example document beforehand):