Link a Brand Product to a Menu Item
Products listed by official manufacturers or distributors, go through a verification process.
Products are automatically submitted for verification upon saving. Once a Menu Item is linked to a Brand Product, they display the Brand's official details.
Integrated Partners are strongly encouraged to:
- Link as many menu items to brand products as possible, or
- Provide sufficient product details for Weedmaps to classify the item automatically.
Why Product Linking Matters
- Reviews for verified products persist longer and aggregate across all listings carrying the same product.
- Brands maintain their product data, including descriptions, strain associations, and flavor/effect profiles.
You can link a Brand Product to a Menu Item by using any of the operations below:
Method | Description | Try It! |
---|---|---|
POST | Create a new Menu Item linked to the Brand Product | POST Menu Item |
PATCH | Update a Brand Product link on the Menu Item | PATCH Menu Item |
PUT | Upsert a new Menu Item linked to the Brand Product | PUT Menu Item |
You can explore available Brand Products with these operations:
Method | Description | Try It! |
---|---|---|
GET | Retrieve a Brand's Product Catalog | Retrieve a Brand's Product Catalog |
GET | Retrieve a Brand's Product | Retrieve a Brand Product |
You can utilize the many
filters
parameters on these operation for search and discovery.
Send back theproduct_id
.
product_id
.- You can pass the Brand Product identifier as the
product_id
attribute in the Menu Item payload. - Add your internal Brand's Product identifier to the Menu Item payload as the
external_product_id
to help Weedmaps link data across locations or sync systems (optional). - The Brand's identifier is optional as it will receive that attribute through the Brand Product
{
"product_id": "integer",
"external_product_id": "your internal product id"
}
Indirect Classification (Automatic Curation)
Weedmaps offers curation services:
- Our curation team reviews menus and assigns verified products.
- Retailers interested in this service should contact their Weedmaps Account Representative.
You can also use the external_product_id
field to:
- Help auto-link products across locations, when the same identifier is reused under the same Organization.
Brand Product Curation
Manual links performed by retailers or Weedmaps—whether through our mutual client or curation services—are intentional and high-value. Do not overwrite these verifications.
Do Not Overwrite Manual Brand Product Links.
Only sending attributes that have been changed on your end will help mitigate Product Link churn.
Best practice: persist the Weedmaps
product_id
and apply that in your Menu Item operations.
Overwriting manually linked Brand Products undermines the integrity of curated content and significantly reduces the effectiveness of our joint efforts.
Clearing Brands vs Products
If you need to clear the Linked Product, setting:
{
"brand_id": null
}
On the Menu Item payload will not clear the product—the brand will be re-inferred from the product. To fully clear both, set:
{
"brand_id": null,
"product_id": null
}
Updated 4 days ago