We are updating our direct-to-garment (DTG) products by introducing a new, larger standard front print area of 15″ × 18″ for selected items and sizes. As a result, you can create bigger and bolder designs.
To support this, we are updating our API. This guide will walk you through exactly how to prepare your API integration for this change.
What is changing in the API?
The core change is the introduction of a new placement name. To take advantage of the larger print area, you will need to use front_large in your API calls. The old placement name, front, is being phased out for new product creation.
Understand the impact on your products
First, determine how this change affects your new and existing products.
For your existing products:
- No immediate action is required. Your current products using the front placement will continue to sell, and we will process orders as usual.
- If you edit an existing product, our system will automatically update its placement to
front_large. At that point, you should check your design's scaling and resolution (DPI) to ensure it looks great on the larger 15" x 18" area. - Upgrading is optional. If you want to use the larger print area for existing items, simply update the product's placement information.
For new products you create:
- After May 17, 2025, you must use
front_largefor all new products with a front print. The front placement will no longer be available in the product catalog for affected items.
Update your API calls
Next, you'll need to know where to implement the new front_large placement name in your code. You can confirm the new placement name is available by calling a specific product from the catalog:
- In API V1, check under:
Result > Product > Files > Type - In API V2, check under:
Data > Placements
Here’s where to use front_large in your API requests:
API V1 Implementation:
-
To create a new Sync Product: specify the placement in the request body in
Sync_variants > Files > Type -
To create a new order: specify the placement in the request body in
Items > Files > Type -
To create a mockup generation task: specify the placement in the request body in
Files > Placement
API V2 Implementation:
-
To create a new order: specify the placement in the request body in
Order_items > Placements > Placement -
To create a mockup: specify the placement in the request body in
Products > Placements > Placement
By following these steps, your API integration will be fully prepared for the switch to our new, larger DTG print placements.
Learn more about the print placement change and affected products here