The Swatch Image is the small square Bloomingdale's shows as the color or pattern button on the product page and in collection grids. Bloomingdale's requires a swatch for any product sold in more than one colorway and for any product page with more than one fabrication, and Osello lists it as a required field for Bloomingdale's. Each colorway has its own swatch, shared by all of that colorway's sizes, and the swatch has to match both the product and the variant's color attributes, since a mismatch is what makes a shopper click "Camel" and see a photo of "Black".
The rules
| Rule | Value |
|---|---|
| Required | Yes in Osello's Bloomingdale's taxonomy; Bloomingdale's requires it for any product in more than one colorway or with more than one fabrication |
| Level | Variant, one swatch per colorway shared by its sizes |
| Dimensions | 200 x 200 pixels at 300 ppi |
| Format | JPEG or PNG, publicly viewable |
| File size | Up to 10 MB |
| Must match | The product's color or pattern, and the variant's NRF Color Code and Site Facing Color Description |
| Prints, textures and finishes | A crop of the actual product |
| Solid, matte colors | A generic color block is acceptable |
Use the swatch from your source data when one exists. Otherwise crop a 200 x 200 pixel square from a representative area of the garment. Leave the field blank only when the product has a single colorway and no swatch exists.
Swatches do not go in the Alternate Images set. They have this field of their own.
Examples
| Product | Swatch | Verdict |
|---|---|---|
| Silk blouse in "Ivory" | Flat ivory color block | Good: a solid, matte color |
| Wool coat in "Camel Herringbone" | Square crop of the herringbone weave | Good: a texture needs the real fabric |
| Midi dress in "Garden Floral" | Square crop from the skirt showing the print | Good |
| Satin slip in "Champagne" | Flat beige color block | Weak: a satin finish needs a crop, and flat beige misrepresents the sheen |
| Sweater in "Heather Gray" | A crop of the whole sweater at 200 x 200 | Weak: the swatch should show the fabric, not the garment silhouette |
| Jeans in "Medium Wash" | Swatch reused from the "Dark Wash" variant | Weak: the swatch has to match this variant's color |
Common mistakes
- Skipping the swatch on a two-color style. Bloomingdale's requires one as soon as there is more than one colorway.
- A color block for a print, a metallic or a textured knit.
- Different swatch and color name: a swatch cropped from the "Navy" photos on a variant whose Site Facing Color Description says "Black".
- A rectangular or low-resolution crop. The swatch is a 200 x 200 pixel square at 300 ppi.
- Uploading the swatch as one of the alternate images instead of here.
How Osello fills this field
The Swatch Image is a variant-level field set once per colorway and shared by every size of that colorway. Osello uses the swatch from your source data when one is attached to the product; when there is none, the AI crops a 200 x 200 pixel square from a representative area of the variant's product images, choosing a fabric crop for prints, textures and finishes and accepting a plain color block only for solid, matte colors. Crops made by the AI wait for your approval before they are used (see approve AI-edited images). The field stays blank only for a single-colorway product with no source swatch, and because it is marked required, that blank appears in the listing's readiness check (see required fields and listing readiness).
Other Bloomingdale's requirements are in the Bloomingdale's field directory.
Frequently asked questions
When does Bloomingdale's require a swatch?
Yes. For any product sold in more than one colorway and for any product page with more than one fabrication. A single-colorway product with no swatch in the source can leave the field blank.
What size is a Bloomingdale's swatch?
200 x 200 pixels at 300 ppi, saved as a JPEG or PNG at a publicly viewable URL.
Can I use a plain color square instead of a photo crop?
Only for solid, matte colors. Prints, textures, metallics and other finishes need a crop of the actual product.
Does every size need its own swatch?
No. The swatch belongs to the colorway, and all sizes of that colorway share it. Each colorway in the style group needs a different swatch.
What does the swatch have to match?
The product's actual color or pattern, and the variant's NRF Color Code and Site Facing Color Description. If those three disagree, the listing is wrong somewhere.