Brand Partner Guide

This guide explains how Materialogue structures brand and product data. Use it when adding or updating your brand information and product catalog through the Brand Partner API.

Every field is described with its data type, whether it is required or optional, accepted formats, and real examples. Switch to the Simpolo Example tab above to see a fully worked product submission.

Quick Start

To start using the API, you need an API key issued by Materialogue. Once you have it, all requests must include it in the header:

X-API-Key: your-api-key-here

Get your API key from the Materialogue team. Each key is scoped to your brand only — you cannot access or modify another brand's data.
Check your brand profile to see what's currently on file.
Update your profile — only send the fields you want to change.
List your products and start adding or updating.

Brand Profile Fields

Your brand profile is what appears on the Materialogue brand information page. Fields marked Required must be provided for a complete listing.

Field	Type	Required	Description & Format	Example
`name`	String	Required	Your brand name. Set by Materialogue — cannot be changed via API.	`"Kohler"`
`logo_url`	String (URL)	Required	Full URL to your brand logo. Host it on DigitalOcean Spaces or another CDN. SVG or PNG preferred, transparent background.	`"https://materialogue.blr1.cdn..."`
`description`	String	Optional	About your brand — history, manufacturing, positioning. Plain text. 100–500 words recommended.	`"Kohler Co. is a global leader..."`
`hero_images`	Array of Strings	Optional	Array of image URLs shown as banners on the brand page. Landscape orientation, minimum 1400px wide.	`["https://cdn.../hero.jpg"]`
`headquarters`	Object	Required	Two-line address object with `address_line1` and `address_line2` — both strings.	See below
`collections`	Array of Objects	Optional	Each item has `name` (string) and `cover_image` (URL). Sending this replaces the entire list.	See Collections section
`channel_partners`	Array of Objects	Optional	Each item has `state` (string) and `cities` (array of strings). Sending this replaces the entire list.	See Channel Partners section
`contact`	Object	Required	Fields: `brand_name`, `address`, `phone`, `email` — all strings.	See below

Complete brand update example

{
  "description": "Kohler Co. is a global leader in kitchen and bath products, founded in 1873.",
  "logo_url": "https://materialogue.blr1.cdn.digitaloceanspaces.com/brands/kohler/logo.svg",
  "hero_images": ["https://materialogue.blr1.cdn.digitaloceanspaces.com/brands/kohler/hero1.jpg"],
  "headquarters": {
    "address_line1": "6th Floor, Corporate Office Tower, Ambience Island, NH-08",
    "address_line2": "Gurugram, Haryana 122001, India"
  },
  "contact": {
    "brand_name": "Kohler India Corporation",
    "address": "6th Floor, Corporate Office Tower, Gurugram, Haryana 122001",
    "phone": "+91 124 4561000",
    "email": "[email protected]"
  }
}

Partial updates: You only need to send the fields you want to change. Omitting a field leaves it unchanged.

Collections

Collections represent your product ranges or lines. They appear on your brand page as visual tiles.

Field	Type	Required	Description
`name`	String	Required	Name of the collection, e.g. `"Purist"`, `"Alchimia"`, `"Impatto"`
`cover_image`	String (URL)	Optional	Cover image URL. Square or portrait preferred. Hosted on DigitalOcean Spaces.

"collections": [
  { "name": "Alchimia",  "cover_image": "https://materialogue.blr1.cdn.digitaloceanspaces.com/brands/simpolo/collections/alchimia.jpg" },
  { "name": "Impatto",   "cover_image": "https://materialogue.blr1.cdn.digitaloceanspaces.com/brands/simpolo/collections/impatto.jpg" },
  { "name": "Basaltino", "cover_image": "" }
]

Full replacement:

Sending collections replaces the entire list. Always include all collections when updating.

Channel Partners

Channel partners show your dealer/distributor network, organised by state and city.

Field	Type	Required	Description
`state`	String	Required	State name, e.g. `"Maharashtra"`, `"Gujarat"`, `"Delhi NCR"`
`cities`	Array of Strings	Optional	Cities within that state, e.g. `["Mumbai", "Pune", "Nagpur"]`

"channel_partners": [
  { "state": "Gujarat",      "cities": ["Ahmedabad", "Surat", "Vadodara", "Rajkot"] },
  { "state": "Maharashtra",  "cities": ["Mumbai", "Pune", "Nagpur"] },
  { "state": "Delhi NCR",    "cities": ["New Delhi", "Noida", "Gurgaon"] }
]

Full replacement:

Sending channel_partners replaces the entire list. Include all states when updating.

Required Product Fields

Every product must have these four fields. If any is missing, the product will be rejected.

Field	Type	Description	Valid values
`category`	String	Top-level product category. Must match exactly (case-sensitive).	`Walls & Floor` · `Sanitary` · `Paints` · `Surfaces` · `Fabrics` · `Lights` · `Electricals` · `Hardware`
`primary_sub_category`	String	Sub-category within the main category. See the full Category Taxonomy below.	e.g. `Tile`, `Basin Area`, `Laminate`, `Fan`
`secondary_sub_category`	String	Specific product type within the sub-category.	e.g. `Porcelain Tile`, `Wash Basin`, `Solid Laminate`
`product_name`	String	The product's display name. Keep it clear and descriptive.	e.g. `"Alchimia Graphite"`

Category values are exact strings.

Use the Category Taxonomy section to find the correct spelling. Use "Walls & Floor" not "Walls and Floor".

Identification & Classification

Field	Type	Description
`product_code`	String	Your internal SKU or model number, e.g. `"INFB0RX0326"`. Indexed for fast lookup.
`primary_sku`	String	Primary SKU if different from product_code.
`sku_variation`	String	Variation identifier for colour/size variants of the same base product. e.g. `"1198x1198-Matt"`
`collection`	String	The collection/range this product belongs to, e.g. `"Alchimia"`.
`tags`	Array of Strings	Free-form search tags, e.g. `["vitrified", "large-format", "concrete-look"]`.

Descriptions & Pricing

Field	Type	Description
`tagline_description`	String	A short one-line tagline shown on product cards. Keep under 80 characters.
`description`	String	Full product description. Plain text. No HTML. 50–300 words recommended.
`price1`	Number	Primary price. A number only — no currency symbols or commas. `850` not `"₹850"`.
`unit1`	String	Unit for price1. Common values below.
`price2`	Number	Secondary price — used for alternate pricing tiers.
`unit2`	String	Unit for price2.

Common unit values

/piece/set/sqft/sqm/mtr/rmt/roll/box/litre/kg/pair

Specification Fields

These fields describe the physical and technical properties of a product. All are optional strings unless noted. Only fill in fields relevant to your product category — see Specs by Category for guidance.

Appearance

color String

color_for_filter String

color_code String

finish String

pattern String

shape String

grain_type String

Physical

size String

thickness String

material String

marble_type String

stone_type String

wood_species String

installation_type String

Lighting / Electrical

wattage String

temperature String

beam_angle String

voltage Number

power_consumption Number

illumination String

Sanitary-specific

faucet_type String

cock_type String

rim_type String

thermostatic Boolean

shower_function String

no_of_outlets Number

water_saving String

Fan / Electrical

sweep_size String

number_of_blades Number

fan_speed Number

air_delivery Number

speed_levels Number

control_method String

Fabrics / Soft Furnishings

martindale Number

pile_height String

roll_size String

curtain_width String

pasting String

nrc_value Number

Paint

paint_type String

color_type String

Hardware / Security

lock_type String

door_thickness String

door_control_system_type String

camera_features String

actuation_type String

Technical Documents

hd_textures_pdf String (URL)

specs_sheet String (URL)

installation_guide String (URL)

special_features String

Product Images

Images are stored as an array of URL strings. All images must be hosted on DigitalOcean Spaces or another publicly accessible CDN before being added to Materialogue.

Field	Type	Description
`images`	Array of Strings	Array of image URLs. First image is the primary/thumbnail. Minimum 1 image recommended.

"images": [
  "https://materialogue.blr1.cdn.digitaloceanspaces.com/Images/Simpolo/alchimia-graphite-main.jpg",
  "https://materialogue.blr1.cdn.digitaloceanspaces.com/Images/Simpolo/alchimia-graphite-r1.jpg"
]

Category Taxonomy — Walls & Floor

Use the exact strings below for category, primary_sub_category, and secondary_sub_category.

Walls & Floor

Tile

Ceramic TilePorcelain TileVitrified TileGVT TileGlass Tile

Marble

Italian MarbleIndian MarbleBrazilian MarbleTurkish MarbleSpanish MarbleIranian MarbleExotic Marble

Natural Stone

GraniteLimestoneSandstoneQuartziteTravertineOnyxSlate

Engineered Stone

Composite StoneQuartz SlabSolid SurfaceTerrazzo

Mosaic

Glass MosaicStone MosaicMetal MosaicCeramic MosaicShell Mosaic

Wood Flooring

Solid Wood FlooringEngineered Wood FlooringVinyl Wood FlooringLaminate Wood FlooringReclaimed Wood FlooringOutdoor Deck Flooring

Carpet

Carpet RollCarpet TileRug

Category Taxonomy — Sanitary

Sanitary

Toilet Area

WCToilet SeatFlush TankFlush ValveFlush PlateBidetHealth FaucetAngle ValveBib CockStop CockDrain Cover

Basin Area

Wash BasinBasin FaucetAngle ValveVanityMirror

Shower Area

Shower DiverterShower ArmHand ShowerOverhead ShowerBath SpoutBody ShowerShower Enclosure

Wellness

Bath TubJacuzziBath Tub FaucetSteam Generator

Accessories

Toilet Paper HolderRobe HookTowel HolderTumbler HolderSoap HolderToilet Brush Holder

Category Taxonomy — Paints

Paints

Indoor Paint

WhiteBeigeYellowOrangeRedPinkGreenBluePurpleBrownGreyBlack

Exterior Paint

WhiteBeigeYellowOrangeRedPinkGreenBluePurpleBrownGreyBlack

Wood Coating

Clear CoatSpecial Coat

For paints, secondary_sub_category is the colour family (e.g. "Beige"). The actual shade name goes in product_name.

Category Taxonomy — Surfaces

Surfaces

Veneer

Natural VeneerDyed VeneerReconstituted VeneerDecorative VeneerTextured Veneer

Laminate

Solid LaminateWood LaminateMetallic LaminateMarble LaminateStone LaminateDecorative LaminateFabric LaminateInternal Laminate

Panel

Aluminum Composite PanelCharcoal PanelPVC PanelMetal PanelFiber Cement PanelMDF / HDF PanelHardwood PanelResin Solid Surface PanelAlabaster PanelAcoustic PanelAcrylic PanelNatural Fiber Panel

Rattan / Cane

Natural Rattan/CaneSynthetic Rattan/Cane

Wallpaper

Non-Woven WallpaperVinyl WallpaperFabric WallpaperGrasscloth WallpaperMetallic WallpaperNatural Fibre Wallpaper

Category Taxonomy — Fabrics

Fabrics

Curtain

Sheer CurtainBlackout CurtainEyelet CurtainLinen CurtainVelvet CurtainGeometric CurtainFloral CurtainStriped Curtain

Upholstery

Leather UpholsteryVelvet UpholsteryLinen UpholsteryCotton UpholsteryBrocade UpholsteryJacquard UpholsteryOutdoor Upholstery

Sheer

Plain SheerPrinted SheerEmbroidered Sheer

Category Taxonomy — Lights

Lights

Architectural Light

DownlightSpotlightLinear LightStrip LightCove LightPanel LightTrack LightStep LightOutdoor LightFlood Light

Decorative Light

ChandelierPendant LightWall SconceTable LampFloor LampCeiling LightCluster Light

Category Taxonomy — Electricals

Electricals

Switches & Accessories

SwitchSwitch PlateSocketTouch PanelFan Regulator

Fan

Ceiling FanWall FanTable FanPedestal FanExhaust FanBladeless Fan

Electrical Accessories

Motion SensorPresence SensorNight LightDimmerBuzzerBellInfra Red SensorMosquito RepellantSpeaker

Category Taxonomy — Hardware

Hardware

Architectural Hardware

Mortise HandleMortise LockPull HandlePull KnobWall HookDoor Control System

Digital Solution

Digital Door LockDigital Drawer LockDigital SafeSmart CameraVideo Door Access Control

Glass Solution

Handle for GlassPivot FittingPatch FittingProfile FittingSliding FittingLock - Glass Door

Aluminium Profile

Frame ProfileHandle ProfileEdge Profile

Recommended Specs by Category

These are the fields shown on Materialogue's Selection Sheet and Order Sheet exports. Fill in the relevant fields for accurate export output.

Category	Sub-Category	Spec 1	Spec 2
Walls & Floor	Tile	`size`	`finish`
Walls & Floor	Marble	`collection`	`thickness`
Walls & Floor	Natural Stone	`collection`	`thickness`
Walls & Floor	Engineered Stone	`size`	`thickness`
Walls & Floor	Wood Flooring	`size`	`thickness`
Walls & Floor	Carpet	`size`	`thickness`
Sanitary	Toilet Area	`color`	`finish`
Sanitary	Basin Area	`color`	`finish`
Sanitary	Shower Area	`color`	`finish`
Sanitary	Wellness	`size`	`finish`
Sanitary	Accessories	`color`	`finish`
Surfaces	Veneer	`size`	`finish`
Surfaces	Laminate	`size`	`finish`
Surfaces	Panel	`size`	`pattern`
Surfaces	Rattan / Cane	`size`	`pattern`
Surfaces	Wallpaper	`pattern`	`roll_size`
Paints	Indoor Paint	`paint_type`	`collection`
Paints	Exterior Paint	`paint_type`	`collection`
Paints	Wood Coating	`finish`	`collection`
Fabrics	Curtain	`collection`	`material`
Fabrics	Upholstery	`collection`	`material`
Fabrics	Sheer	`collection`	`material`
Lights	Architectural Light	`color`	`temperature`
Lights	Decorative Light	`size`	`material`
All others	—	First 2 non-empty from: `material`, `color`, `finish`, `size`, `thickness`, `wattage`, `pattern`, `shape`, `temperature`

Image Guidelines

Images referenced in the API must be publicly accessible URLs. They can be hosted anywhere — on your own CDN, your website, or uploaded to Materialogue's DigitalOcean Spaces (see the Image Upload tab for details).

Image type	Recommended size	Format	Notes
Brand logo	Any (vector preferred)	SVG or PNG (transparent bg)	Used in headers and brand listings
Brand hero banner	Min 1400 × 600px	JPG or WebP	Landscape. Full-width banner on brand page.
Collection cover	600 × 600px or 600 × 800px	JPG or WebP	Square or portrait. Used as collection tile.
Product image	Min 800 × 800px	JPG, PNG, or WebP	Square recommended. White or neutral background for first image.

CDN URL format

If your images are hosted on Materialogue's DigitalOcean Spaces, the CDN URL follows this structure:

https://materialogue.blr1.cdn.digitaloceanspaces.com/[folder-path]/[filename]

Where:
[folder-path] — the folder within the bucket for your brand (provided by Materialogue)
[filename] — the uploaded file name including extension (e.g. logo.png, hero-1.jpg)

Examples by image type:

brands/[brand-name]/logo.png                       → Brand logo
brands/[brand-name]/hero-1.jpg                     → Hero banner
brands/[brand-name]/collections/[collection].jpg   → Collection cover
brands/[brand-name]/products/[sku-code].jpg        → Product image

Contact the Materialogue team to get upload access to DigitalOcean Spaces for your brand folder.

SIMPOLO

Real Product Example

Step-by-step: how Simpolo would add a tile product to Materialogue using the Brand Partner API

This example is based on a real product from simpolo.com. Every field below maps directly to what the General Guide describes — this shows exactly how to translate a real product listing into a Materialogue API payload.

Note on images: Simpolo hosts their images on their own S3 bucket. Before submitting to Materialogue, those images would need to be re-uploaded to Materialogue's DigitalOcean Spaces. The image URLs in this example show the Materialogue CDN format that would be used after re-hosting.

The Product

We're using ALCHIMIA GRAPHITE — a large-format vitrified floor and wall tile from Simpolo's Alchimia collection.

Product Name

Alchimia Graphite

Collection

Alchimia

Product Code

INFB0RX0326

Colour

Grey

Finish options

Matt · Polished

Thickness

9 mm (all sizes)

Available sizes

1198×1198 mm · 1198×1798 mm · 1198×2398 mm · 598×1198 mm

Application

Wall Tiles · Floor Tiles · Living Room · Bedroom · Bathroom · Kitchen

The product has 4 sizes × 2 finishes = 8 variants total. Each variant is submitted as a separate product entry. This example focuses on the 1198×1198 mm Matt variant first, then shows how the second variant differs.

Choosing the Category Path

Simpolo's tile products map to the Walls & Floor category. Here's how to pick the right path:

Walls & Floor → Tile → Vitrified Tile

Field	Value	Why
`category`	`"Walls & Floor"`	Simpolo makes floor and wall tiles — this is the correct top-level category.
`primary_sub_category`	`"Tile"`	The Alchimia collection is a tile product, not stone or wood flooring.
`secondary_sub_category`	`"Vitrified Tile"`	Simpolo describes this as a vitrified large-format tile. Porcelain Tile would also be acceptable.

Exact strings only.

Copy the values above exactly — including capitalisation and the ampersand in Walls & Floor. Any variation will be rejected.

Full API Payload

This is the complete JSON body for the ALCHIMIA GRAPHITE in 1198×1198 mm, Matt finish.

brand is automatic. You do not include a brand or brandId field — the API reads your brand from your API key and assigns it automatically.

{
  // ── Required fields ─────────────────────────────────────
  "category":                 "Walls & Floor",
  "primary_sub_category":     "Tile",
  "secondary_sub_category":   "Vitrified Tile",
  "product_name":             "Alchimia Graphite",

  // ── Identification ───────────────────────────────────────
  "product_code":             "INFB0RX0326",
  "sku_variation":            "1198x1198-Matt",
  "collection":               "Alchimia",
  "tags":                     ["vitrified", "large-format", "concrete-look", "grey", "living-room"],

  // ── Descriptions ─────────────────────────────────────────
  "tagline_description":      "Large-format vitrified tile with concrete-inspired aesthetic",
  "description":              "Add a touch of elegance and luxury to your interiors with the Alchimia Graphite tile. Part of the Alchimia collection, this large-format vitrified tile features an R9 anti-slip surface and Posh+ finish, combining raw beauty with the strength of high-performance ceramics. Suitable for living rooms, bedrooms, bathrooms, kitchens, balconies, and commercial spaces.",

  // ── Pricing ──────────────────────────────────────────────
  "price1":                   850,
  "unit1":                    "/sqft",

  // ── Specification fields ─────────────────────────────────
  "size":                     "1198 x 1198 mm",
  "thickness":               "9 mm",
  "finish":                   "Matt",
  "color":                    "Grey",
  "color_for_filter":         "Grey",
  "special_features":         "R9 Anti-Slip Surface, Posh+ Surface, Liquid Repellent, Scratch Resistant, Heat & Fire Resistant, Impact Resistant, Chemical & Stain Resistant, Frost Resistant, Antibacterial, Anti-Algae",

  // ── Technical documents ───────────────────────────────────
  "specs_sheet":             "https://simpolo-web.s3.ap-south-1.amazonaws.com/uploads/media/guides/Simpolo-Technical.pdf",
  "installation_guide":      "https://simpolo-web.s3.ap-south-1.amazonaws.com/uploads/media/guides/Simpolo-Installation.pdf",

  // ── Images (hosted on Materialogue DO Spaces) ────────────
  "images": [
    "https://materialogue.blr1.cdn.digitaloceanspaces.com/Images/Simpolo/alchimia-graphite-preview.jpg",
    "https://materialogue.blr1.cdn.digitaloceanspaces.com/Images/Simpolo/alchimia-graphite-r1.jpg",
    "https://materialogue.blr1.cdn.digitaloceanspaces.com/Images/Simpolo/alchimia-graphite-r2.jpg"
  ]
}

Field Annotations

Why each field was chosen and how it maps to the product listing on Simpolo's website.

Field	Value used	Source / Reason
`category`	`"Walls & Floor"`	Simpolo lists it under Wall Tiles and Floor Tiles — this is the parent category in Materialogue.
`primary_sub_category`	`"Tile"`	Direct product type — a tile, not marble, stone, or wood flooring.
`secondary_sub_category`	`"Vitrified Tile"`	Simpolo manufactures vitrified and GVT tiles. Vitrified Tile covers large-format floor/wall tiles like Alchimia.
`product_name`	`"Alchimia Graphite"`	Taken directly from Simpolo's product listing. Does not include the size or finish — those go in `sku_variation`.
`product_code`	`"INFB0RX0326"`	Simpolo's internal product code shown in their product URLs and image paths.
`sku_variation`	`"1198x1198-Matt"`	Since the same product comes in 4 sizes and 2 finishes, `sku_variation` distinguishes each variant. Format: `size-finish`.
`collection`	`"Alchimia"`	Simpolo groups this under the "Alchimia" collection — should match the collection name on the brand page.
`size`	`"1198 x 1198 mm"`	Taken from Simpolo's packing details. Include the unit (mm) as part of the string. This is Spec 1 on exports for Tile products.
`thickness`	`"9 mm"`	All Alchimia tiles are 9 mm thick according to the packing table on Simpolo's site.
`finish`	`"Matt"`	This variant is the Matt finish. This is Spec 2 on exports for Tile products.
`color`	`"Grey"`	Simpolo explicitly lists "Grey" as the colour on the product page.
`color_for_filter`	`"Grey"`	Used for colour filtering in the app — should match `color` unless a more generic grouping is needed.
`special_features`	Feature list	Simpolo lists feature icons on the product page (Liquid Repellent, Scratch Resistant, etc.). Consolidated into one comma-separated string.
`specs_sheet`	PDF URL	Simpolo provides a public technical PDF — linked directly here.
`installation_guide`	PDF URL	Simpolo's installation guide PDF — linked directly here.
`images`	Array of 3 URLs	Simpolo has 3 images per product. Re-upload to Materialogue's DO Spaces before submitting (see Image Guidelines).
`price1` / `unit1`	`850` / `"/sqft"`	Tiles are priced per square foot. Simpolo's exact pricing would be confirmed by their team.

Handling Variants

The Alchimia Graphite tile comes in 4 sizes × 2 finishes = 8 individual SKUs. Each one is a separate product entry in Materialogue. Here's how to structure all 8:

Size variants (Matt finish)

Variant 1 (shown above)

1198 × 1198 mm

sku_variation: "1198x1198-Matt"

size: "1198 x 1198 mm"

Variant 2

1198 × 1798 mm

sku_variation: "1198x1798-Matt"

size: "1198 x 1798 mm"

Variant 3

1198 × 2398 mm

sku_variation: "1198x2398-Matt"

size: "1198 x 2398 mm"

Variant 4

598 × 1198 mm

sku_variation: "598x1198-Matt"

size: "598 x 1198 mm"

Finish variants (1198×1198 mm)

Matt (shown above)

Matt

finish: "Matt"

sku_variation: "1198x1198-Matt"

Polished

finish: "Polished"

sku_variation: "1198x1198-Polished"

Rule of thumb: Any property that affects price, look, or specification should be a separate product entry. The product_name stays the same across all variants — only sku_variation, size, finish, and price1 change.

Size Variant Example

Here is the payload for the second variant — 1198×1798 mm, Polished finish — showing only the fields that change from the first example:

{
  // ── Same required fields ─────────────────────────────────
  "category":                 "Walls & Floor",
  "primary_sub_category":     "Tile",
  "secondary_sub_category":   "Vitrified Tile",
  "product_name":             "Alchimia Graphite",

  // ── Same product code, different SKU variation ───────────
  "product_code":             "INFB0RX0326",
  "sku_variation":            "1198x1798-Polished",  // ← changed
  "collection":               "Alchimia",

  // ── Specs that change ────────────────────────────────────
  "size":                     "1198 x 1798 mm",     // ← changed
  "finish":                   "Polished",            // ← changed
  "thickness":               "9 mm",
  "color":                    "Grey",

  // ── Price may differ for larger size ─────────────────────
  "price1":                   920,                   // ← may differ
  "unit1":                    "/sqft",

  // ── All other fields remain the same ─────────────────────
  "description":             "Add a touch of elegance and luxury...",
  "special_features":        "R9 Anti-Slip Surface, Posh+ Surface...",
  "specs_sheet":             "https://simpolo-web.s3.ap-south-1.amazonaws.com/uploads/media/guides/Simpolo-Technical.pdf",
  "installation_guide":      "https://simpolo-web.s3.ap-south-1.amazonaws.com/uploads/media/guides/Simpolo-Installation.pdf",
  "images": [
    "https://materialogue.blr1.cdn.digitaloceanspaces.com/Images/Simpolo/alchimia-graphite-preview.jpg"
  ]
}

What Shows on Exports

When a designer adds an Alchimia Graphite tile to a project and generates a Selection Sheet or Order Sheet, here's what appears in the spec columns:

Spec columns for Walls & Floor > Tile

Spec 1 — size: 1198 x 1198 mm

Spec 2 — finish: Matt

This is why size and finish are the most important spec fields for any Tile product. If either is left empty, that column will be blank on the export.

Export	Column A (Spec 1)	Column B (Spec 2)
Selection Sheet	Size — 1198 x 1198 mm	Finish — Matt
Order Sheet	Size — 1198 x 1198 mm	Finish — Matt
Excel Export	Size — 1198 x 1198 mm	Finish — Matt

Image Upload

Images referenced in the API must be publicly accessible URLs. You have two options for hosting your images:

Option 1 — Materialogue-Hosted: Share your image files with us and we'll host them on our CDN. You get back ready-to-use URLs.

Option 2 — Self-Hosted: Host images on your own public server or CDN and use those URLs directly in your API calls.

Option 1: Materialogue-Hosted

Don't have your own hosting? No problem. Send us your files and we'll host them on our global CDN.

Prepare your image files following the Image Specs below.
Send the files to the Materialogue team via email or WhatsApp (see Submit Your Images).
Include a label for each file so we know where it belongs — e.g. "Kohler logo", "Alchimia Graphite 600×600 main view".
We upload the files to your brand folder on DigitalOcean Spaces and send you back the CDN URLs.
Use those URLs in your API calls — in the logo_url, hero_images, collections[].cover_image, or images fields.

Example — what you send:

kohler-logo.svg → label: "Brand logo"
purist-basin-front.jpg → label: "Purist Basin, SKU KH-1234, front view"
purist-basin-angle.jpg → label: "Purist Basin, SKU KH-1234, angle view"

Example — what you receive back:

https://materialogue.blr1.cdn.digitaloceanspaces.com/brands/kohler/logo.svg
https://materialogue.blr1.cdn.digitaloceanspaces.com/brands/kohler/products/purist-basin-front.jpg
https://materialogue.blr1.cdn.digitaloceanspaces.com/brands/kohler/products/purist-basin-angle.jpg

Option 2: Self-Hosted

If you already have a CDN, cloud storage, or public web server, you can host images yourself and pass the URLs directly in your API calls.

Upload your images to your own public server, CDN, or cloud storage (e.g. AWS S3, Google Cloud Storage, Azure Blob, Cloudflare R2, or your own website).
Make sure the image URLs are publicly accessible — no authentication or login required to view them.
Use HTTPS URLs for security.
Use the public URLs directly in your API calls — in the logo_url, hero_images, collections[].cover_image, or images fields.

Example — self-hosted URLs:

"logo_url": "https://cdn.yourbrand.com/assets/logo.svg"
"hero_images": ["https://cdn.yourbrand.com/banners/hero-2025.jpg"]
"images": [
  "https://cdn.yourbrand.com/products/basin-front.jpg",
  "https://cdn.yourbrand.com/products/basin-angle.jpg"
]

Requirements for self-hosted images:

URLs must be publicly accessible (no authentication required)
Use HTTPS links only
URLs should be permanent and stable — avoid temporary or expiring links
Follow the same Image Specs for sizes and formats

Image Specs

Image type	Recommended size	Format	Notes
Brand logo	Any (vector preferred)	SVG or PNG (transparent bg)	Used in headers and brand listings.
Brand hero banner	Min 1400 × 600px	JPG or WebP	Landscape. Full-width banner on brand page.
Collection cover	600 × 600px or 600 × 800px	JPG or WebP	Square or portrait. Used as collection tile.
Product image	Min 800 × 800px	JPG, PNG, or WebP	Square recommended. White or neutral background for primary image.

Tip: You can send multiple images at once. Batch them by product or by type and label each clearly. There's no limit on how many you can send per request.

Submit Your Images

Send your images to the Materialogue team via either of the following:

Channel	Details
Email	[email protected]
WhatsApp	Share via your dedicated brand partner contact

Please allow up to 1 business day for URLs to be returned. Urgent uploads can be flagged in your message.

Once you have your CDN URLs, use them directly in the API. The General Guide tab explains exactly which fields accept image URLs for brand profiles, collections, and products.