Documentation Woo Sold Out Badge

Woocommerce Sold Out Badge

Version 4.0.0

Last Updated: March 2026 Author: Gema75 Plugin Type: WooCommerce Extension

Introduction

Woocommerce Sold Out Badge is a powerful and flexible badge system for WooCommerce that allows you to create and manage professional “Sold Out” badges for out-of-stock products. Create eye-catching badges that clearly communicate stock status to your customers.

Perfect for:
  • Creating professional SOLD OUT badges for out-of-stock products
  • “Back Soon” or “Restocking” badges for restocking items
  • Category-specific sold out badges
  • Variable product support with real-time badge switching

Requirements

  • WordPress: 6.5 or higher
  • WooCommerce: 5.0 or higher (tested up to 10.0.5)
  • PHP: 7.4 or higher
Important: This plugin requires WooCommerce to be installed and activated. It will not function without WooCommerce.

Features

Professional Sold Out Badges

  • Create unlimited sold out badges
  • Global or category-specific badges
  • Shows on catalog and single product pages
  • Real-time updates for variable products

Preset Library

  • 12 professionally designed SVG badges
  • Various “SOLD OUT” designs and styles
  • Options: “GONE”, “ALL GONE”, “BACK SOON”, and more
  • Instant preview and selection

Smart Stock Logic

  • Simple Products: Shows badge when out of stock
  • Variable Products: Shows badge only when ALL variations are out of stock
  • Real-time updates when variations are selected

Custom Design Options

  • Custom text (e.g., “Sold Out”, “Gone”, “Back Soon”)
  • Custom colors for text and background
  • Adjustable padding and margins
  • Border radius controls for rounded corners
  • Opacity settings
  • Custom image upload

Live Preview

  • Real-time design updates
  • Drag to position the badge
  • See changes instantly before publishing

Variable Product Support

  • Real-time badge switching
  • Shows badge only when ALL variations are out of stock
  • Updates instantly on variation selection

Performance Optimized

  • Built-in caching system
  • Minimal database queries
  • Optimized for block and classic themes
  • Lightweight CSS and JavaScript

Theme Compatibility

The plugin automatically detects your theme type and uses the appropriate display method:

  • Classic Themes: Storefront, Astra, Flatsome, OceanWP, and all traditional WooCommerce themes
  • Block Themes: Twenty Twenty-Four, Twenty Twenty-Five, and all Full Site Editing (FSE) themes

HPOS Compatibility

Fully compatible with WooCommerce High-Performance Order Storage.

Pro Tip: For variable products, the badge appears only when ALL variations are out of stock. If any variation is available, no badge is shown – encouraging customers to purchase the available options.

Installation

Standard Installation

  1. Download the plugin ZIP file from CodeCanyon
  2. Go to WordPress Admin → Plugins → Add New
  3. Click “Upload Plugin” and select the downloaded ZIP file
  4. Click “Install Now” and then “Activate”
  5. The plugin will automatically check for WooCommerce
  6. A new menu item “Sold Out Badges” will appear in your admin sidebar

FTP Installation

  1. Extract the plugin ZIP file on your computer
  2. Upload the soldout-badges folder to /wp-content/plugins/
  3. Go to WordPress Admin → Plugins
  4. Find “Woocommerce Sold Out Badge” and click “Activate”
Note: After activation, the plugin creates a default settings structure. You can modify these settings anytime from the Display Settings page.

Getting Started

Quick Start Guide

  1. Create Your First Sold Out Badge

    Go to Sold Out Badges → Add New. Give your badge a title (e.g., “Default Sold Out Badge”).

  2. Choose Assignment Type

    Select “Global” to show on all out-of-stock products, or “Specific Categories” to limit to certain categories.

  3. Design Your Badge

    Choose a preset image, upload a custom image, or create a text badge with custom colors and styling.

  4. Publish Your Badge

    Click Publish and the badge will automatically appear on applicable out-of-stock products.

Creating a Simple Sold Out Badge – Step by Step

  1. Go to Sold Out Badges → Add New in your WordPress admin.
  2. Enter a title for the badge (internal name, e.g., “Standard Sold Out Badge”).
  3. In the Badge Assignment section, choose:

      – Global – Shows on all out-of-stock products

      – Specific Categories – Shows only in selected categories

  4. In the Badge Types section, choose “Use Custom Design” for a text badge.
  5. Set your badge text (e.g., “SOLD OUT”, “GONE”, “BACK SOON”), colors, padding, and border radius.
  6. Adjust the badge position by dragging the live preview or entering top/left values.
  7. Click Publish to save your badge.

Creating an Image Badge

  1. Follow steps 1-3 above.
  2. In the Badge Types section, choose “Use Preset Image” to select from 12 pre-designed badges.
  3. Click on any preset badge to select it.
  4. Alternatively, choose “Use Custom Design” and upload your own image in the “Custom Badge Image” section.
  5. Publish your badge.
Live preview: The preview area updates in real-time as you adjust colors, padding, and position. Drag the badge to position it visually.

Badge Types & Assignment

Assignment Type Description Use Case
Global Shows on all out-of-stock products One consistent sold out badge for your entire store
Specific Categories Shows only on out-of-stock products in selected categories Different badges for different departments (e.g., “SOLD OUT” for clothing, “DISCONTINUED” for electronics)

How Category Selection Works

When you select “Specific Categories”, you can choose multiple categories. The badge will appear on any product that belongs to at least one of the selected categories.

Example:
  • ✓ Clothing (selected) – Badge appears on out-of-stock items
  • ├── Men’s Clothing – Badge appears (inherits from parent)
  • │ ├── Shirts – Badge appears
  • │ └── Pants – Badge appears
  • └── Women’s Clothing – Badge appears
  • ✗ Electronics (not selected) – No badge on out-of-stock items
  • └── Phones – No badge

Note: Category hierarchy is respected automatically. Selecting a parent category applies the badge to all child categories.

Stock Status Logic

The plugin intelligently determines when to show sold out badges based on product type and stock status.

Simple Products

  • Out of Stock: Badge appears
  • In Stock: No badge appears

Variable Products

Smart Logic: For variable products, the badge appears only when ALL variations are out of stock.
Scenario Badge Display
Catalog – All variations out of stock ✅ Badge appears
Catalog – At least one variation in stock ❌ No badge appears
Product view – Customer selects an out-of-stock variation ✅ Badge appears (real-time update)
Product view – Customer selects an in-stock variation ❌ Badge disappears (real-time update)
Pro Tip: The real-time badge switching on variable products encourages customers to purchase available variations instead of leaving when they see a “Sold Out” badge.

Catalog vs Single Product Views

  • Catalog/Shop Pages: Shows badge based on overall product stock status
  • Single Product Page: Shows badge with real-time updates when variations are selected

Display Settings

Access via Sold Out Badge → Display Settings

Setting Options Description
Display in Catalog View Yes/No Show sold out badges on shop, category, and archive pages
Display in Single Product View Yes/No Show sold out badges on individual product pages

Badge Creation Settings

When creating/editing a badge, you’ll find these options:

Field Description
Badge Assignment Global (all products) or Specific Categories
Badge Types Use Custom Design or Use Preset Image
Preset Images Choose from 12 professionally designed sold out badges
Text Color Customize text color
Background Color Customize background color (default: #c9326c)
Badge Text Custom text (e.g., “SOLD OUT”, “GONE”, “BACK SOON”)
Padding Top, Bottom, Left, Right padding in pixels
Border Radius Individual corner radius settings for rounded corners
Position Top and Left position (draggable preview)
Opacity 0-10 opacity setting
Custom Image Upload your own badge image

Frequently Asked Questions

General Questions

Q: How many badges can I create?

A: Unlimited! Create as many sold out badges as you need for different categories or styles.

Q: Can I use my own images for badges?

A: Absolutely! You can upload any image (JPG, PNG, GIF, SVG) from your media library, or choose from our 12 preset SVG badges.

Q: Will this work with my theme?

A: Yes! The plugin automatically detects whether you’re using a classic or block theme and loads the appropriate display methods. It works with Storefront, Astra, Flatsome, Twenty Twenty-Four, and all popular WooCommerce themes.

Q: Will this slow down my site?

A: No – the plugin is optimized with caching, minified assets, and conditional loading. It only loads scripts and styles where needed, ensuring minimal performance impact.

Stock Logic Questions

Q: How does the badge work with variable products?

A: The badge appears only when ALL variations are out of stock. If any variation is available, no badge is shown. When a customer selects a variation, the badge updates in real-time based on that variation’s stock status.

Q: Can I show a “Low Stock” badge instead of “Sold Out”?

A: Yes! You can customize the badge text to anything you want, such as “Only X Left!”, “Low Stock”, or “Hurry Up!”. The badge will appear based on stock status (out of stock). For low stock thresholds, you would need to customize the logic.

Q: Does it work with backordered products?

A: Yes. If a product is marked as “in stock” but on backorder, no badge will appear. If it’s out of stock, the badge will appear.

Troubleshooting

Issue Solution
Badge Not Showing
  • Verify badge is published (not draft)
  • Check display settings are enabled
  • For simple products: verify product is OUT OF STOCK
  • For variable products: verify ALL variations are out of stock
  • Clear any caching plugins
Badge Showing When Product is In Stock
  • Check if product is correctly set to “In Stock”
  • For variable products, check if any variation is in stock
  • Clear any caching plugins
Variable Badge Not Updating
  • Ensure variations have correct stock status
  • Check browser console for JavaScript errors
  • Clear any caching plugins
Radius/Padding Not Applying to Variable Products
  • Clear your browser cache
  • Deactivate and reactivate the plugin
  • Check that badge meta includes radius values

Support

For support, please contact us through CodeCanyon:

Before contacting support:
  • Check that you meet all system requirements
  • Ensure WooCommerce is active and up to date
  • Verify your products are out of stock (or check variable products)
  • Try disabling other plugins to test for conflicts
  • Check your PHP error logs for clues

Woocommerce Sold Out Badge v4.0.0 | Documentation by Gema75 © 2026