The best way to ease you into the Menu API is to go over each part of a product page as it's displayed on Weedmaps. This gives you a better understanding of how the parts work together to display a product for sale. We will give a brief overview of each part while giving greater detail in the guide.
Each menu item for sale on Weedmaps has its own page. This displays all of the product details ranging from the dispensary that is selling it to the information with the THC/CBD amounts. As we go through this guide, we will be creating all of the needed resources for our test Listing to display a menu item for sale. At the end, your test Listing should have a similarly displayed product.
The dispensary name, Hank's Dank, is displayed as a link back to its menu. You may also hear this referred to as a Listing. While we don't create dispensaries via the Menu API — that's done by the Listing Owners themselves through the Weedmaps UI — we will use their associated
listing_wmid to create menu items for sale.
All menu items should have basic information that describes what they are. While a name is required, it's also suggested to specify a description (body), genetics, and THC/CBD percentages.
It's also important to note that each menu item has
online_orderable statuses. This former of these two attributes determines whether or not the given menu item shows up in the UI. The latter then informs the customer/patient that they can purchase that item online.
There are currently two types of menu items you can create in Weedmaps: Custom and Branded. A custom menu item gives you complete flexibility in how that item is created, from its description to the image used. On the other hand, a branded menu items have these attributes managed by the brand itself.
Branded menu items also go through a verification process, which will give the item a blue checkmark badge. This badge appears once the brand itself verifies that the Listing is authorized to carry their products and does indeed sell that item. Brands have a lot of flexibility on how they verify menu items: Some do so en masse, whereas others verify item by item. Each menu item will still appear while it's waiting to be verified; however, the badge won't show until its verification is complete.
Each menu item can have one image associated to it. We do have a default image that will be shown in cases when one is unavailable, although you should always try to assign the image URL to the menu item so that we may process and render it in our UI.
A menu item can be represented by one of two pricing models: Unit and Variant. Unit states that the given item is sold without any other options available. This would be typically be the case for edibles or concentrates. Variant pricing, on the other hand, is commonly used for flower menu items. This would allow you to set a different price for each weight breakpoint — 1g, 3.5g, 7g, and so on — for a single product. Each of these pricing options would then show up on the same page, which is the example shown here.
Now that we have a general overview of how the information displays on a product page, we can move on to the next step in the guide, Managing Menu Items.
Updated over 1 year ago