Shopify Liquid Tutorial: Build Custom Product Badges
TL;DR: You can create dynamic product badges by adding conditional Liquid logic to your theme’s product card snippet. This method allows you to display labels like “Sale,” “New,” or “Out of Stock” automatically based on product data without needing external apps.
Creating custom product badges is an effective way to highlight inventory status, promotions, or new arrivals, thereby boosting conversion rates. This guide will walk you through the process of implementing these badges directly into your Shopify theme using Liquid, ensuring they remain responsive to your store’s real-time data. By leveraging native Shopify features, you avoid the bloat and cost associated with third-party badge apps, giving you full control over styling and logic.
If you want to dig deeper, check out our guide on Slow Travel & Rail-First Itineraries Are Gaining Momentum.
Step-by-Step Instructions
First, navigate to your Shopify admin dashboard and select “Online Store,” then click “Themes.” Locate the active theme and click “Edit code.” In the “Sections” folder, find the file responsible for displaying product cards, typically named “product-card.liquid” or similar. Open this file to begin editing the code structure that renders each product on your collection pages.
Next, identify the section within the code where you want the badge to appear. Usually, this is above the product image or near the title. Insert the following Liquid logic to create a dynamic badge. For example, to display a “Sale” badge when a product has a discount, use this conditional statement: {% if product.compare_at_price > product.price %}Sale{% endif %}. You can repeat this logic for other conditions, such as checking if a product is on sale or newly added.
After adding the logic, save your changes. To ensure the badges look appealing, you must style them. Go to the “Assets” folder and open your main CSS file, usually “base.css” or “theme.css.” Add styles for the .badge class to define the background color, text color, padding, and border radius. For instance, a red background with white text works well for sales, while green is suitable for “In Stock” indicators.
Pro Tips
Use metafields for advanced customization. If you need specific badges for unique categories, create custom metafields on your products. You can then query these metafields in Liquid to display specific text. Ensure your badge text is concise to prevent layout shifts on mobile devices. Finally, always test your changes on both desktop and mobile views to confirm that the badges do not overlap with other elements and remain readable across different screen sizes. This attention to detail ensures a seamless shopping experience for your customers.
FAQ
Q: Can I use badges on single product pages?
A: Yes, you can add similar Liquid logic to the “main-product.liquid” template. This allows badges to appear on individual product detail pages, reinforcing urgency or status directly where customers make purchase decisions.
Q: Do custom badges affect page loading speed?
A: No, simple Liquid logic has a negligible impact on performance. Since the code runs server-side and generates minimal HTML, it does not add significant JavaScript or CSS bloat, keeping your store fast and responsive for all visitors.
Q: What if I want to remove badges for specific collections?
A: You can add a nested conditional check within your Liquid code. For example, use {% unless collection.handle == ‘excluded-collection’ %} to wrap your badge logic, ensuring that specific collections do not display any automatic badges at all.
