[Skip to main content](#vessel-content)

#  Printful plugin

Details    Written by: Administrator    Category: [Pther extensions](/support/documentation/hikashop/other-extensions)     Published: 17 November 2026     Hits: 8

## Installation

1. Install the plugin with the HikaShop or Joomla installer, then publish it in the plugin manager (HikaShop Printful Plugin).
2. In your Printful developer account, generate a Private Token with these scopes: view and manage all orders, view all store information, view all store products, view and manage webhooks.
3. Open the settings of the plugin, paste the token in "Private Token" and save. The "Store" field then lists the Printful stores of the token: choose yours and save again.
4. Choose in "Order Status" the statuses at which an order is sent to Printful, and in "Shipped Status" the status an order takes when Printful ships it. Then use "Register the shop" so that Printful tells the shop when an order ships, fails or is cancelled (the site must use HTTPS).
5. To sell a Printful product, either import it: "Import products" in the settings opens the list of the products of your Printful store, and "Import" creates the HikaShop product, unpublished, with its sizes and colors as variants already linked to their Printful variants, the Printful retail prices and codes, and its picture; check it (its tax category and prices especially), then publish it.
6. Or link an existing HikaShop product: edit it, and the "Printful Product" part lets you search the products of your Printful store and link the HikaShop product to one of them. Only linked products are sent to Printful. Once the product is saved, "Printful variants" lists its variants (or the product itself) with the Printful variant each one is sent as: they are matched automatically on their size and color, or their code, and you can change any of them. A variant can also be left to its main product's link.

Orders are created in Printful as drafts, unless "Auto Confirm" is on. An order is sent once: its Printful order number is kept on the order and shown in its history. When a line has no Printful variant, nothing is sent and the history says which line; choose its variant in the product, then set the order status again.

## Configuration

![The Printful settings](/images/doc/plugins/printful/plg_hikashop_printful_settings.png)

- **Private Token**: the token generated in your Printful developer account. Without it the plugin shows "Please configure Private Token first."
- **Store**: the Printful store the orders are sent to. Shown once a token is saved; a message says so when the token gives access to no store.
- **Import products**: its link (Trigger on Joomla, a button on WordPress) opens the list of the products of your Printful store, each with its "Import" button, or a link to the HikaShop product already made from it.
- **Order Status**: the order statuses that trigger the export to Printful. None ticked, nothing is exported.
- **Shipping Method**: the Printful shipping speed requested: Standard (5-12 days, default), Printful Fast (2-5 days) or Economy.
- **Register the shop**: its link (Trigger on Joomla, a button on WordPress) points the Printful notices of the token at this shop. Printful keeps one address per token: registering replaces any address the token sent its notices to before. Each notice is checked with the key Printful gives at registration; a notice without it is ignored.
- **Shipped Status**: the status given to an order, with the usual status email to the customer, when Printful ships it. None, the status does not change. Either way the tracking number and address are added to the order history.
- **Tracking URL field**: optional, an order custom field that receives the tracking address when Printful ships.
- **Auto Confirm**: No by default, the orders stay drafts in Printful and you confirm them there. Yes confirms them at once, which charges your Printful account immediately.
- **Packing Slip Email**, **Packing Slip Store Name** and **Packing Slip Logo URL**: what is printed on the packing slip in the parcel. Each one empty is simply left out.
- **Debug Mode**: No by default. Yes writes the requests to Printful and its answers to the HikaShop log.
- **Sync Product Name**: No by default. Yes renames the HikaShop product after the Printful product when you link it.
- **Sync Product Images**: No by default. Yes adds the main picture of the Printful product to the HikaShop product gallery when you link it.

## Troubleshooting

- **"Please configure Private Token first."**: paste the token and save.
- **"No Printful stores found for the configured access token"**: the token has no access to a store; check it in your Printful developer account.
- **"Please enable the HikaShop Printful plugin first via the Joomla plugin manager."**: publish the plugin.
- **"Printful Export Error"** in the history of an order: the end of the message is the answer of Printful. Turn on Debug Mode to see the request in the HikaShop log.
- **The status does not change when Printful ships**: use "Register the shop" again (it says where Printful sends the notices) and check that a "Shipped Status" is chosen. A failed or cancelled order at Printful is written in the order history.
