Product - Liquid Object Reference - 1.0.0

Object Name Product
Version 1.0.0

Description

The Product object contains information about a product that the Store sells.

Attributes

Attribute Type Description
add_to_cart_text String Returns the text to show on the ‘Add to Cart’ button
barcode String Returns the value of the Barcode attribute
brand Brand Returns the Brand of this Product
buy_it_now_text String Returns the text to show on the ‘Buy it Now’ button
can_add_to_cart? Boolean Indicates whether the Product can be added to the Cart
can_pickup? Boolean Indicates whether the Product is enabled for pickup, ie Click and Collect
can_purchase? Boolean Indicates whether the Product can be purchased. Accounts for stock levels, discontinued products, and general availability
can_request_quote? Boolean Indicates whether the Product can be included in a quote request (if enabled on the Store)
can_select_quantity? Boolean Indicates whether the quantity can be set by the customer. If false, it means the quantity is predefined and cannot be set by customer.
categories List[ProductCategory] Returns a list of ProductCategories this Product belongs to
condition String Returns the value of the Condition attribute
content_blocks List[ContentBlock] Returns a list of ContentBlocks belonging to this Product
data Object Returns a custom data object for this object
discontinued? Boolean Indicates whether this Product has been discontinued
id String Returns the unique id for this Product
identifier String Returns the value of the Identifier attribute
image Image Returns the main image for this Product
location_groups List[LocationGroup] Returns a list of LocationGroups for this Product
master? Boolean Returns true if this Product is a master Product
maximum_quantity Number Returns the maximum quantity of this Product that can purchased in a single Order
name String Returns the value of the Name attribute
path String Returns the url path for this Product
pickup_locations List[StockLocation] Returns a list of Stock Locations this product can be picked up from
pricing ProductPricing Returns the Pricing object for this Product
product_code String Returns the value of the Product Code attribute
related_products List[Product] Returns a list of Related Products
search_description String Returns the value of the Search Description attribute
slug String Returns the value of the Slug attribute
supplier_code String Returns the value of the Supplier Code attribute
tags List[Tag] Returns a list of Tags for this Product
unavailable_text String Returns the text to display when the Product is unavailable
upc String Returns the value of the UPC attribute
url String Returns the complete url for this Product
variant? Boolean Returns true if this Product is a variant

Bookings

Attribute Type Description
bookable? Boolean Indicates whether the Product is a bookable Product
product_bookable_locations List[ProductBookableLocation] Returns a list of ProductBookableLocations for this Product

Bundles

Attribute Type Description
bundle_lead? Boolean Indicates whether this Product is the lead product in a bundle
product_features List[ProductFeature] Returns a list of any ProductFeatures for this Product

Master Variants

These attributes are only applicable to master Products

Attribute Type Description
variant_documents List[Document] Returns a list of Documents for variant Products for which this Product is the master
variant_files List[File] Returns a list of Files for variant Products for which this Product is the master
variant_images List[Image] Returns a list of Images for variant Products for which this Product is the master
variant_media List[Medium] Returns a list of Media for variant Products for which this Product is the master
variant_types List[VariantType] Returns a list of VariantTypes for this variant Product
variant_videos List[Video] Returns a list of Videos for variant Products for which this Product is the master
variants PaginatedList[Product] Returns a list of variant Products for which this Product is the master

Media

Attribute Type Description
documents List[Document] Returns a list of Documents for this Product
files List[File] Returns a list of Files for this Product
images List[Image] Returns a list of Images for this Product
media List[Medium] Returns a list of Media for this Product
videos List[Video] Returns a list of Videos for this Product

Restricted Products

Some attributes related to Restricted Products

Attribute Type Description
approval_status String Returns the approval status of the current customer for this Product. One of: approved, completed, expired, pending, or none.
current_approved_quantity Number The maximum quantity of this Product that the current customer is allowed to purchase. If this Product is not restricted, this value will be blank.
pending_approval_date Timestamp Returns the date that this customer’s approval starts. If they have no pending approval, this value will be blank.
restricted? Boolean Returns true if this Product is restricted.
restricted_text String Returns the text to show to indicate this Product is restricted

Rich Content Sections

Attribute Type Description
downloads_content String Returns the content of the Downloads section as rich text
downloads_label String Returns the label to use for the Downloads section
features_content String Returns the content of the Features section as rich text
features_label String Returns the label to use for the Features section
specifications_content String Returns the content of the Specifications section as rich text
specifications_label String Returns the label to use for the Specifications section
summary_content String Returns the content of the Summary section as rich text
support_content String Returns the content of the Support section as rich text
support_label String Returns the label to use for the Support section
warranty_content String Returns the content of the Warranty section as rich text
warranty_label String Returns the label to use for the Warranty section

SEO

These are some attributes that are useful for SEO purposes

Attribute Type Description
meta_description String Returns the value of the Meta Description attribute
meta_keywords String Returns the value of the Meta Keywords attribute
meta_title String Returns the value of the Meta Title attribute
social_image Image Returns the image to be used when sharing this Product

Shipping

If the Store is enabled for Shipping, Products that can ship will have been assigned to one of the Store’s shipping methods

Attribute Type Description
can_ship? Boolean Indicates whether the Product is able to be shipped via one of the Store’s shipping methods
shipping_methods List[String] Returns a list of shipping methods that are available for this Product

Stock

Attribute Type Description
available_for_pickup? Boolean Indicates whether the Product has stock available for pickup
on_backorder? Boolean Indicates whether the Product will be on backorder when purchased. Only applicable if track_inventory? is true
out_of_stock? Boolean Indicates whether the Product is out of stock
out_of_stock_text String Returns the text to display when the Product is out of stock
total_available_to_sell Number Returns the total quantity of this Product available to sell
track_inventory? Boolean Indicates whether this Product tracks stock or not. If true, it means it is possible for this Product to be out of stock

Subscriptions

Attribute Type Description
fixed_term_subscription? Boolean Indicates whether the subscription is a fixed-term subscription
subscription? Boolean Indicates whether this Product is purchaseable as a subscription

Traits

Attribute Type Description
trait_groups List[TraitGroup] Returns a list of TraitGroups for this Product
traits List[Trait] Returns a list of Traits for this Product

Variants

These attributes are only applicable to variant Products

Attribute Type Description
master Product Returns the master Product for this variant Product if there is one
variant_choices List[VariantChoice] Returns a list of VariantChoices for this variant Product
variant_options List[VariantOption] Returns a list of VariantOptions for this variant Product
variant_title String Returns the value of the Variant Title attribute

Objects that return Products

Back to Object List

Back to Liquid Reference for 1.0.0

 

 
Back to Documentation