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.
You must enable the Wisepops embed block in your Shopify theme editor for these built-in properties to work. Please ensure that you have completed the step "Update your Shopify theme" on the installation page.
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
Most of these customer properties are only available for logged-in visitors. customer.is_logged_in can help to include non-logged-in visitors. For example, to target visitor who have never placed an order, use:
customer.orders_count is lower than 1, or customer.is_logged_in is false
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.
