Placements

Each Image you attach to an order item references a placement — the location on the product where the image is printed (e.g. Front, Back, Left Chest). Placements are identified by string IDs; the ID-to-name map is defined globally and refined per enterprise.

Use getPlacements to look up the valid placement IDs you can pass in Image.placement on createOrderFromGtin.

Get Placements

query {
  getPlacements {
    placements {
      id
      name
    }
    activePlacements {
      id
      name
    }
    discounts {
      id
      value
    }
  }
}

Response shape

Field	Description
placements	Global mapping of placement IDs to display names. The full set of placements available on the platform.
activePlacements	Subset enabled for your enterprise. If empty/null, treat all global placements as active.
discounts	Per-placement discount overrides (percentage off the placement's printing price).

Placement ID reference

The full set of global placement IDs is below. These are platform-wide — they apply to every enterprise (there is no enterprise-specific "Right Chest", it is 4 everywhere). Your enterprise's activePlacements is a subset of this list; when activePlacements is empty, every global placement is valid. Always read getPlacements at runtime rather than hardcoding — this table is for reference.

ID	Placement		ID	Placement
1	Front		15	Front Left
2	Back		16	Front Right
3	Left Chest		17	Top Half Front
4	Right Chest		18	Top Half Back
5	Neck Label		19	Front Left Leg
6	Right Sleeve		20	Front Right Leg
7	Left Sleeve		21	Side Left Leg
8	All Over Print		22	Side Right Leg
9	Impression		23	Nape
10	Top		24	Bottom Front
11	Bottom		25	Bottom Back
12	Front 2		26	Collar
13	Back 2		27	Side Left
14	Back 3		28	Side Right

note

All Over Print (8) is mutually exclusive with other placements and is only offered on certain (own / manually-created) blank products, so it may be unavailable on some supplier blanks even though the ID is globally valid.

Using placement IDs in orders

Pass the placement ID as the placement field on each image when creating an order:

mutation {
  createOrderFromGtin(
    input: {
      orderNumber: "ORD-1"
      shopId: "shop_123"
      shippingAddress: { country: "US" }
      orderItems: [
        {
          gtin: "00123456789012"
          quantity: 1
          images: [
            {
              url: "https://cdn.example.com/front.png"
              placement: "1"
              type: printing
            }
            {
              url: "https://cdn.example.com/left-chest.png"
              placement: "3"
              type: printing
            }
          ]
        }
      ]
    }
  ) {
    id
  }
}