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 | 
    
  
  
    
      | 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