Overview
In BlackBox, the loadableinownbox attribute—found within the <product> XML tag—indicates whether a product can be shipped “as is,” without requiring additional packaging or inclusion in another container. This is useful for pre-packaged, boxed, or retail-ready items that don’t need protective overpacking.
If set to true, the product will only be placed into a container (e.g., carton, master box) if that container is already being used and has leftover space. It will never trigger the creation of a new container on its own.
Requirements
- Access to BlackBox v4 and above.
Product Information
Example XML snippet with loadableinownbox="true":
<product productid="coffee-machine"
loadableinownbox="true"
bottomonly="false"
endupok="true"
flatok="true"
height="4.00"
length="47.00"
sideupok="true"
toponly="false"
turnable="true"
type="Box"
weight="34.00"
width="39.00"/>-
loadableinownbox = true
- Treats the product as pre-packaged.
- BlackBox will only include this item in another container when space is available and doing so does not require an extra or larger container.
-
loadableinownbox = false
- Default behavior.
- The item will be packed as usual along with other products needing containerization.
Common use cases for loadableinownbox=true (no additional packaging needed):
- Boxed item – A coffee machine in its branded retail box.
- Shrink-wrapped item – A stack of t-shirts shrink-wrapped on a cardboard tray.
- Retail-ready item – A pack of granola bars inside a perforated shelf-ready tray.
Assistance
If any further assistance is needed, please contact our Support team.