Skip to main content

​
Enriching your product catalog

A standard product page shows a name, a bottle image, and a price. That’s not enough for fragrance — customers need to understand how a perfume smells before they can buy with confidence. The Fragrance Library transforms your catalog into a definitive guide to understanding each perfume, without needing to smell it.

​
The business problem

Poorly classified, confusing, and incomplete catalogs are the main reason customers don’t buy perfumes online. They can’t understand the scent, can’t compare products meaningfully, and don’t trust their choice. The result: low conversion, high returns, and lost revenue.

​
The business impact

  • Higher conversion — customers who understand what they’re buying are more confident to purchase
  • Fewer returns — clearer, more visual product information reduces mismatched expectations
  • Increased customer trust — a uniform, professional fragrance language elevates your catalog
  • More time on site — rich product content encourages exploration and discovery

​
What you can build

  • Olfactive profile cards showing the fragrance’s family, subfamilies, and intensity
  • Visual ingredient breakdowns with images, descriptions, and hero ingredient highlights
  • Perfumer profiles linking the creator to their other works
  • Family context — where this fragrance sits in the olfactive landscape
  • Quadrification visuals — the olfactive structure of each fragrance as an image
  • Resized imagery for bottles, ingredients, and families

​
How Fragrance Library works

  1. Connect — you share your Product Feed with EAN codes
  2. Personalize — you choose which data to integrate (ingredients, families, perfumer, visuals)
  3. Visualize — each perfume is enriched with high-quality ingredient images and olfactive data
  4. Integrate — enriched content appears directly on your product pages
  5. Update — new launches or catalog changes sync automatically

​
Olfactive profile

Every perfume has a structured olfactive profile: a primary family, an optional secondary family, and intensity. This data powers visual profile cards, radar charts, and classification badges. 
query OlfactiveProfile {
  findPerfumeById(id: "424", lang: "EN") {
    name
    family {
      name
      color
    }
    secondaryFamily {
      name
      color
    }
    family_intensity
    secondary_family_intensity
    intensity
    gender
    classification
    quadrification_url {
      width100
      width500
      width1000
    }
  }
}
The quadrification_url provides the Quadrification — a proprietary visual representation of the olfactive profile. See Olfactive Classification for more on classification and the Quadrification.

​
Ingredient breakdown

Each perfume includes its ingredient list, with proportions and hero flags. Use this to build ingredient carousels, expandable ingredient panels, or educational overlays — letting users visually understand the scent of each perfume by identifying its dominant notes. 
query PerfumeIngredients {
  findPerfumeById(id: "424", lang: "EN") {
    id
    name
    ingredients {
      id
      name
      proportion
      hero
      family {
        name
        color
      }
      image1 {
        urls {
          low
          mid
        }
      }
    }
  }
}
Hero ingredients (hero: 1) are the defining notes of the fragrance — highlight these prominently. Proportion values indicate relative weight in the composition.

​
Perfumer profile

Surface the creator behind the fragrance. Many users develop loyalty to specific perfumers once they discover the connection between their favorite fragrances. 
query PerfumerInfo {
  findPerfumeById(id: "424", lang: "EN") {
    name
    perfumers {
      id
      name
      slug
    }
  }
}
Fetch the full perfumer profile for a dedicated section or link-through page: 
query PerfumistDetail {
  findPerfumistBySlug(slug: "francis-kurkdjian", lang: "EN") {
    id
    name
    bio
    house
    image1 {
      urls {
        low
        mid
        high
      }
    }
    perfumes
  }
}

​
Visual assets

WikiParfum provides resized imagery for perfumes, ingredients, and families in multiple sizes. Use the image field (or image1, image2 for ingredients) to get responsive assets without managing image processing. 
query PerfumeVisuals {
  findPerfumeById(id: "424", lang: "EN") {
    name
    image {
      urls {
        low
        mid
        high
      }
    }
    isDark
  }
}
The isDark flag indicates whether the bottle image has a dark background, useful for adapting UI contrast.

​
EAN-based enrichment

For retailers integrating with existing catalog systems, perfumes can be looked up directly by EAN barcode — no ID mapping required. See Catalog Integration for the full catalog setup flow. 
query EnrichByEAN {
  findPerfumeByEAN(ean: "8411061994351", lang: "EN") {
    id
    name
    description
    brand {
      name
    }
    family {
      name
      color
    }
    ingredients {
      name
      hero
    }
    image {
      urls {
        low
        mid
        high
      }
    }
    gender
    quadrification_url {
      width100
      width500
    }
    perfumers {
      name
    }
  }
}

​
Multi-language support

All enrichment content — ingredient names, descriptions, family names, perfumer bios — is available in multiple languages. Pass the appropriate lang parameter to get content localized for your market. 
query EnrichInFrench {
  findPerfumeByEAN(ean: "8411061994351", lang: "FR") {
    id
    name
    description
    family {
      name
    }
    ingredients {
      name
    }
  }
}
This enables the same enrichment experience across different markets and storefronts without managing translations.