Since May 17, 2025, Printful has offered a larger standard front print area of 15″ × 18″ for selected direct-to-garment (DTG) items. This allows you to integrate bigger and bolder designs into your store. This guide will walk you through how to link your API integration to this standard.
Which placement name should I use in the API?
To utilize the 15″ × 18″ print area, you must use the front_large placement name in your API calls. The legacy placement name, front, has been phased out for new product creation in the Printful catalog, though it remains active for existing products created before the transition.
How does this change affect my 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 Printful 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