Skip to main content

​
Expert fragrance classification

Most e-commerce catalogs classify perfumes by brand, gender, or price — attributes that say nothing about how a fragrance actually smells. WikiParfum solves this by providing an expert olfactive classification for every fragrance in its database. Every perfume is classified into an olfactive family and subfamily by fragrance experts, in partnership with Fragrances of the World (the leading global fragrance classification authority founded by Michael Edwards). This structured taxonomy provides a universal language for organizing, navigating, and understanding perfumes — a capability most retailers and brands don’t have access to internally.

​
The business problem

Without proper classification, your customers face a wall of products with no way to navigate by scent. They can’t filter by “woody” or “floral”, can’t understand why they like certain perfumes, and can’t discover new ones based on olfactive affinity. The result: confusion, abandonment, and missed sales.

​
What you can build

  • Family-based navigation — let users browse fragrances by olfactive character (Floral, Woody, Ambery, Citrus…)
  • Visual family maps — each family includes a color and imagery for rich UI components
  • Olfactive profile cards — show a perfume’s primary and secondary family with intensity levels
  • Family-based filtering — narrow catalogs by olfactive character across search, recommendations, and product lists
  • Educational content — help users understand what families mean and how they relate to each other

​
The family hierarchy

WikiParfum organizes fragrances into primary families (broad olfactive categories) and subfamilies (more specific character descriptions). Each perfume is classified with up to two levels:
LevelFieldDescription
PrimaryfamilyThe dominant olfactive character (e.g., Floral, Woody, Ambery)
SecondarysecondaryFamilyA complementary olfactive dimension
Each level includes an intensity value (family_intensity, secondary_family_intensity) that indicates how strongly that family character is expressed in the fragrance.

​
Browsing the family tree

Retrieve all primary families to build top-level navigation: 
query PrimaryFamilies {
  findFamilies(search: { lang: "EN", isPrimary: true, order_by: "position asc" }) {
    id
    name
    slug
    color
    description
    image {
      urls {
        low
        mid
      }
    }
  }
}
Each family includes a color (hex) and image, making it straightforward to build visual navigation grids, wheels, or maps. To retrieve all families including subfamilies: 
query AllFamilies {
  findFamilies(search: { lang: "EN" }) {
    id
    name
    slug
    color
    isPrimary
    level
  }
}
See Families for the full entity reference.

​
Reading a perfume’s olfactive classification

Every perfume exposes its full classification: 
query PerfumeClassification {
  findPerfumeById(id: "424", lang: "EN") {
    name
    family {
      name
      color
    }
    family_intensity
    secondaryFamily {
      name
      color
    }
    secondary_family_intensity
    intensity
  }
}
This data powers olfactive profile cards, radar charts, and classification badges on product pages.

​
The Quadrification

The Quadrification is WikiParfum’s proprietary visual representation of a perfume’s olfactive profile. It renders the family composition and intensity as a graphic that users can instantly understand — without needing fragrance expertise. 
query PerfumeQuadrification {
  findPerfumeById(id: "424", lang: "EN") {
    name
    quadrification_url {
      width100
      width500
      width1000
    }
  }
}
The quadrification_url returns pre-rendered images in multiple sizes, ready to embed in product pages, comparison views, or discovery interfaces.

​
Filtering by family

Use family-based filters to narrow any query — perfumes, recommendations, or search results: 
query WoodyPerfumes {
  findPerfumes(search: {
    lang: "EN"
    page: "0,20"
    filters: {
      family: "woody"
    }
  }) {
    id
    name
    brand {
      name
    }
    family {
      name
      color
    }
  }
}
You can also filter by subfamily, or combine primary and secondary family filters. See Filtering & Pagination for all family filter options.

​
Family combinations

Each family includes data about its most common pairings — which families frequently appear together as primary and secondary classifications: 
query FamilyCombinations {
  findFamilyById(id: "5", lang: "EN") {
    name
    combinations {
      name
      color
    }
  }
}
This enables “related families” modules and helps users understand how olfactive families interact.