Shopify Built-In Properties

Lisa Fockens Updated by Lisa Fockens

If you installed our Shopify app before April 22, 2020, please install the app again from your Wisepops settings (click on Setup code, then Install on Shopify).


Built-in properties are custom properties that are set automatically when using our Shopify app. They're ready to be used as conditions in your display scenario, or as dynamic variables in your campaign's content. This feature is extremely powerful and offers endless possibilities. Do you want to display a message to your VIP customers who haven't passed an order in the last 30 days? 👇

This page describes the different built-in properties you can use out of the box after installing our Shopify app. If you'd like something else, you can still add your own custom properties.

Product properties

product.available

Definition: This property is equal to false when the product can’t be purchased.

Use cases: Display a popup on products that are out of stock to push alternative products.

product.price

Definition: This property contains the price of the item currently being viewed.

Use cases: Display a popup with the phone number of your customer support team for expensive items.

product.total_inventory_quantity: 

Definition: This property recalls all stock variants of the product currently viewed.

Use cases: Display a popup on soon-to-be out-of-stock items to create a sense of urgency.

product.tags: 

Definition: This property contains a list of the tags associated with the product currently being viewed.

Use cases: Display a coupon on all the product pages associated with a specific tag.

Cart properties

cart.discount_code

Definition: This property returns the name of the coupon code applied to the cart.

Use cases: Display a popup confirming that a coupon code has been applied.

cart.item_count: 

Definition: This property returns the number of items inside the cart.

Use cases: Encourage your visitors to add more products to their cart.

cart.skus: 

Definition: The SKUs of the products in the cart.

Use cases: Recommend complementary products.

cart.total_price: 

Definition: This property contains the value of your visitor’s cart.

Use cases: Display a popup that is triggered when your visitors haven’t reached the free shipping threshold.

Customer properties

The properties that follow are applicable to logged-in users only.

customer.accepts_marketing:

Definition: This property is equal to true when your customer accepts marketing.

Use cases: You can create an email popup with the condition “customer.accepts_marketing is false” to invite your existing customers to subscribe to your newsletter.

customer.is_logged_in

Definition: This property is equal to true when the visitor is logged in. It's equal to false if the user is logged out (she has no account or is logged out).

Use cases: invite your logged-out users to create an account.

customer.last_order.created_at: 

Definition: This property returns the date of the last order placed by the customer.

Use cases: Create a reactivation popup for your clients who haven’t purchased in a while.

customer.orders_count:

Definition: This property returns the total number of orders a customer has placed.

Use cases: Display a VIP popup for your customers who have placed more than five orders.

customer.tags: 

Definition: This property contains all the tags associated with your client.

Use cases: Create a popup for your VIP customers.

customer.total_spent:

Definition: This property returns the total amount spent on all orders.

Use cases: Create a popup for the customers who have spent a certain amount in your shop.

Debug properties

Are you having a hard time getting a popup to show?

To check the values of the different properties, follow these steps:

  • Open your website in Chrome
  • In Chrome's menu, click on More tools > Developer Tools

  • Open the console tab

  • Copy and paste the following code and press Enter
wisepops('log')

  • Now you'll be able to see the values of the different properties.

If you're still having trouble and you've tried these tips, get in touch via chat.

How To Test Your Custom Properties

How to Target (or Exclude) Visitors Who Have Seen a Specific URL

Contact