Pet Compatibility Manager lets customers save profiles for their pets and shows them which products in your store suit each pet. This guide covers installation, setting up product rules, what customers see, reminders, birthday emails, and every setting.
The extension is compatible with WooCommerce High-Performance Order Storage (HPOS) and works with simple and variable products.
Installation
↑ Back to top- Download the .zip file from your WooCommerce.com account.
- Go to WordPress Admin > Plugins > Add New and click Upload Plugin.
- Choose the .zip file and click Install Now.
- Click Activate.
When you activate the extension, it adds:
- A My Pets tab to the customer’s My Account page.
- A Pet Compatibility tab to the product data panel in the product editor.
- An admin page at WooCommerce > Pet Compatibility.
- A settings tab at WooCommerce > Settings > Pet Compatibility.
- Two emails at WooCommerce > Settings > Emails: Pet Product Replenishment Reminder and Pet Birthday Email.
- Two daily background jobs that send reminder and birthday emails.
Quick start
↑ Back to top- Go to WooCommerce > Pet Compatibility > Compatibility > Category Defaults and set rules for your main categories, such as “Dog” for your dog food category.
- Open any product that differs from its category and set its own rules in the Pet Compatibility tab.
- For food and other supplies, tick Consumable and enter how many days the product lasts.
- Go to WooCommerce > Settings > Pet Compatibility and adjust the badge text and colors to match your theme.
- Sign in as a test customer, add a pet under My Account > My Pets, and visit your shop to see the badges.
How compatibility is decided
↑ Back to topEach product can have rules for species, breeds, life stages, age, weight, size classes, health conditions, activity levels, and diet types. A pet is suitable when it meets every rule the product has. An empty field means no limit.
The rules come from these places, in this order:
- The variation’s own rules, when the customer is looking at a variation. Fields left empty on the variation come from the product.
- The product’s own rules, set in the Pet Compatibility tab.
- Category defaults, when the product has no rules of its own.
- If there are no rules anywhere, compatibility is unknown. No badge is shown by default, and the product never appears in pet filter results.
A few rules work in a specific way:
- Life stage is worked out from the pet’s date of birth. For dogs and cats, a pet is a Baby / Newborn up to 3 months, Young / Junior up to 12 months, an Adult up to 84 months, and a Senior after that. Rabbits use 2, 6, and 36 months, and other species use 3, 12, and 72 months. Developers can change these with the
psm_life_stage_thresholdsfilter. - Size class is worked out from the pet’s weight, using the weight ranges in the Attribute Manager.
- Health conditions: the pet must have at least one of the conditions ticked on the product. A pet with no health conditions saved does not match a product made for a specific condition.
- For a variable product whose variations have their own rules, the product counts as suitable for a pet if at least one variation suits it.
Setting up products
↑ Back to topProduct rules
↑ Back to top- Go to Products and edit a product.
- In the Product data panel, click the Pet Compatibility tab.
- Set the rules the product is made for:
- Suitable for species: leave all unchecked to suit every species.
- Suitable breeds: tick a species first to see its breeds. Leave all unchecked to suit every breed.
- Life stage: leave all unchecked to suit every life stage.
- Age (months) and Weight (kg): enter a minimum, a maximum, or both. Leave a field empty for no limit.
- Size classes: tick a species first to see its sizes.
- Health conditions: tick the conditions the product is made for. Leave unchecked to suit every pet.
- Activity levels and Diet types: useful for food, treats, and supplements.
- Click Update.
Variation rules
↑ Back to topEach variation of a variable product has the same Pet Compatibility fields, under Pet Compatibility (this variation).
- Leave everything empty to use the parent product’s rules.
- Fill in any field to give the variation its own rule for that field. Other fields still come from the product. For example, a dog bed whose sizes only set a weight range stays suitable for dogs only.
On the product page, the badges update as soon as the customer picks a variation.
Consumable products and restock reminders
↑ Back to top- In the product’s Pet Compatibility tab, tick Send a restock reminder after purchase.
- In Remind after, enter how many days the product usually lasts, for example 30 for a monthly flea treatment.
- Click Update.
Variations can have their own reminder interval. If a variation is marked consumable but its interval is empty, the product’s interval is used.
Category defaults
↑ Back to topCategory defaults apply rules to every product in a category that has no rules of its own.
- Go to WooCommerce > Pet Compatibility and open the Compatibility tab.
- Click Category Defaults.
- For each category, set Suitable Species, Life Stage, Age (months), and Weight (kg). To send restock reminders for the whole category, tick This product is consumable and enter Replenish every in days.
- Click Save Category Defaults.
Leave a category completely empty to skip it. When a product is in more than one category with defaults, the extension combines them generously: ranges are widened to the widest one, and a list such as species only restricts the product if every one of its categories restricts it.
Bulk Assign
↑ Back to topBulk Assign applies rules to many products at once.
- Go to WooCommerce > Pet Compatibility > Compatibility and click Bulk Assign.
- Choose a Category, search by product name if needed, and click Filter. A check mark shows products that already have their own settings.
- Tick the products you want, or click Select all visible.
- Set Species, Life Stage, Age Range (months), Weight Range (kg), and optionally Mark as consumable with an interval in days.
- Choose a Write Mode:
- Overwrite existing settings replaces the rules on every selected product.
- Skip products already tagged leaves products that already have their own rules unchanged.
- Click Apply to Selected. A message shows how many products were updated and how many were skipped.
Attribute Manager
↑ Back to topGo to WooCommerce > Pet Compatibility > Attribute Manager to manage the values used in pet profiles and product rules. There are sections for Species, Breeds, Size Classes, Health Conditions, Activity Levels, and Diet Types.
- Built-in values are marked as protected and can’t be renamed or deleted. The built-in species are Dog, Cat, Bird, Fish, Rabbit, Hamster, Reptile, and Horse, each with a starter list of breeds.
- Custom values can be added, renamed, and deleted. Enter a name and the slug is created automatically, for example “Pot Bellied Pig” becomes
pot_bellied_pig. - Size classes belong to a species and have a weight range. Built-in sizes exist for dogs (Toy, Small, Medium, Large, Giant), cats, and rabbits. Add your own for other species.
What customers see
↑ Back to topMy Pets
↑ Back to topCustomers manage their pets under My Account > My Pets. They click Add a Pet and fill in:
- Pet Name and Species (required)
- Breed, Gender, Date of Birth, and Weight (kg)
- Activity Level, Diet, and Health Conditions
- Notes and a Photo (JPG, PNG, GIF, or WebP, up to 2MB)
Customers can add as many pets as they like, and edit or remove them at any time. When reminders are enabled, the page also shows a Restock reminders list with the next reminder date for each consumable product they bought.
Compatibility badges
↑ Back to topSigned-in customers with at least one pet see a badge for each pet on the product page and in the shop and category product lists, for example “Suitable for Max” or “Not recommended for Luna”.
Products with rules also get a Pet Compatibility tab on the product page that lists what the product is made for. When a pet doesn’t match, a This product is made for: box lists each pet that doesn’t match and why, for example “Luna — Species: Cat”.
Guest checker
↑ Back to topWhen Guest / No-Pet Filter is enabled, visitors who aren’t signed in, and customers who haven’t added a pet, see a short checker on products that have rules. It always asks for the species, then only the questions that product’s rules use: life stage, age, size, weight, breed, health, activity, or diet. If a guest skips a question, the result lists what to double-check under Also make sure your pet matches:. Failed rules show the pet’s value, for example “your pet: Senior (at 300 months)”.
Shop filter
↑ Back to topA Filter by pet bar appears above the products on the shop and category pages.
- Customers with pets choose one of their pets and click Filter.
- Guests and customers without pets filter by species, age, and weight, when Guest / No-Pet Filter is enabled.
Only products whose rules the pet meets are shown. Pagination, sorting, and the result count all follow the filter. Click Clear to show all products again.
Restock reminders
↑ Back to topRestock reminders email customers when a supply they bought is likely running low.
- A customer with an account buys a product marked consumable, directly or through its category defaults.
- When the order reaches Processing or Completed, a reminder is scheduled for the interval in days after the order date. Each product in each order is scheduled only once.
- A daily background job sends reminders that are due, using the Pet Product Replenishment Reminder email.
When Allow Customer Opt-Out is enabled, customers can turn reminders on or off for each product in the Restock reminders list on their My Pets page.
Birthday emails
↑ Back to topA daily background job looks for pets whose birthday falls within the Days Before Birthday window and sends the customer the Pet Birthday Email.
- Each pet receives at most one birthday email a year. If a daily run is missed, the email still goes out on the next run inside the window.
- When Include Coupon is enabled, the email includes a new WooCommerce coupon. It is single-use, restricted to the customer’s email address, and expires after the number of days you set.
- Only pets with a Date of Birth saved receive birthday emails.
Settings
↑ Back to topGo to WooCommerce > Settings > Pet Compatibility. Settings are split into three sections: Display, Reminders, and Birthday.
Display
↑ Back to top| Setting | Default | What it does |
|---|---|---|
| Badge on Product Page | On | Shows per-pet badges on single product pages. |
| Badge on Shop Page | On | Shows per-pet badges in the shop and category product lists. |
| Show “Unknown” Badges | Off | Also shows a badge on products with no rules, such as “Compatibility unknown for Max”. |
| Guest / No-Pet Filter | On | Shows a species, age, and weight filter on the shop page, and the compatibility checker on product pages, to guests and to customers who haven’t added a pet. |
| Product Page Location | Below product name | Where the badge appears: below the product name, below the price, before or after the Add to cart button, or manually with the shortcode. |
| Suitable | Suitable for {pet_name} | Badge text when the pet matches. |
| Not Suitable | Not recommended for {pet_name} | Badge text when the pet doesn’t match. |
| Unknown Compatibility | Compatibility unknown for {pet_name} | Badge text when the product has no rules. |
| Padding | 6px 14px | One to four values in px, em, or rem. |
| Border Width (px) | 1 | 0 to 10. |
| Border Radius (px) | 999 | 999 gives a full pill shape. A small value such as 4 gives a rounded square. |
| Font Size (px) | 13 | 9 to 24. |
| Badge Animation | No animation | Plays once when a badge scrolls into view. Visitors who prefer reduced motion never see animations. |
| Per-State Colors | Green, red, and amber | Background, text, and border color for the Suitable, Not Suitable, and Unknown states. |
| Accent Color | #6366f1 | Used for the Filter button, the checker button, and the “made for” box in the Pet Compatibility tab. |
Use {pet_name} in the badge text fields to show the pet’s name.
Reminders
↑ Back to top| Setting | Default | What it does |
|---|---|---|
| Enable Reminders | On | Sends replenishment reminder emails for consumable products. |
| Allow Customer Opt-Out | On | Lets customers turn reminders off per product from their My Pets page. |
Birthday
↑ Back to top| Setting | Default | What it does |
|---|---|---|
| Enable Birthday Emails | On | Sends birthday emails to customers. |
| Days Before Birthday | 7 | How many days before the birthday to send the email, from 0 to 30. |
| Include Coupon | On | Creates a discount coupon and includes it in the email. |
| Coupon Type | Percentage discount | Percentage discount, Fixed cart discount, or Fixed product discount. |
| Coupon Amount | 15 | 1 to 100 for a percentage coupon, or an amount in your store currency for fixed coupons. Decimals are allowed. |
| Coupon Expiry (days) | 7 | How many days the coupon is valid. Enter 0 for no expiry. |
Emails
↑ Back to topBoth emails are standard WooCommerce emails. Go to WooCommerce > Settings > Emails to enable or disable them, change the subject and heading, choose HTML or plain text, and preview them.
| Default subject | Placeholders | |
|---|---|---|
| Pet Product Replenishment Reminder | Time to restock for your pet! | {product_name}, {site_title} |
| Pet Birthday Email | Happy birthday, {pet_name}! | {pet_name}, {site_title} |
The Quick Links on the Pet Compatibility dashboard open each email’s settings directly.
Dashboard
↑ Back to topWooCommerce > Pet Compatibility > Dashboard shows:
- The number of pet profiles and pet owners.
- Reminders pending and reminders sent.
- Upcoming pet birthdays in the next 14 days, with the pet, species, owner, and email.
- Quick links to Category Defaults, Bulk Assign, the plugin settings, and both emails.
Customization
↑ Back to topShortcode
↑ Back to topTo place the product page badge yourself, for example in a page builder layout, set Product Page Location to Manual — use [psm_badge] shortcode and add this shortcode to your single product template:
[psm_badge]
Template overrides
↑ Back to topYou can override these templates by copying them from the extension’s templates folder into a woocommerce folder in your theme, keeping the same path:
myaccount/my-pets.phpandmyaccount/pet-form.phpemails/psm-reminder.phpandemails/psm-birthday.phpemails/plain/psm-reminder.phpandemails/plain/psm-birthday.php
Filters for developers
↑ Back to top| Filter | What it changes |
|---|---|
psm_life_stage_thresholds | The age in months at which a pet moves to the next life stage, per species. |
psm_life_stages | The list of life stages and their labels. |
psm_species_list | The full list of species shown in the store. |
psm_pet_photo_max_bytes | The maximum pet photo size, 2MB by default. |
Example: treat dogs as seniors from 96 months instead of 84.
add_filter( 'psm_life_stage_thresholds', function ( $thresholds ) {
$thresholds['dog']['adult'] = 96;
return $thresholds;
} );
Deactivating and uninstalling
↑ Back to top- Deactivating stops the daily reminder and birthday jobs. Your settings and data are kept.
- Deleting the extension from the Plugins page removes all of its data: settings, product and category rules, custom attributes, customer pet profiles, and reminder history.
Frequently asked questions
↑ Back to topWhy doesn’t a product show a badge?
↑ Back to topCheck three things: the customer is signed in and has added a pet, the product or its category has rules, and Badge on Product Page or Badge on Shop Page is enabled. Products with no rules show no badge unless Show “Unknown” Badges is enabled.
Why is a product missing from the pet filter results?
↑ Back to topThe filter only shows products whose rules the pet meets. Products with no rules, from the product or its categories, are never shown in filter results.
Why is every pet “Not recommended” for a product?
↑ Back to topOpen the product page while signed in as a test customer. The This product is made for: box lists each rule that didn’t match. Common causes are a health condition rule, which needs the pet to have one of the ticked conditions, or an age or weight range that is narrower than intended.
Why didn’t a customer receive a restock reminder?
↑ Back to topCheck that the product or its category is marked consumable with an interval, the order was placed by a customer with an account and reached Processing or Completed, Enable Reminders is on, and the customer hasn’t turned off reminders for that product. Reminders are sent by a daily background job, so they can arrive up to a day after the due date.
Why didn’t a pet get a birthday email?
↑ Back to topThe pet needs a Date of Birth in its profile, Enable Birthday Emails must be on, and the Pet Birthday Email must be enabled under WooCommerce > Settings > Emails. Each pet receives one birthday email a year.
Do the background jobs need a real cron?
↑ Back to topThe extension uses WordPress scheduled events, which run when your site has visitors. On low-traffic sites, ask your host to set up a server cron for WordPress so reminders and birthday emails go out on time.
Is the extension translation ready?
↑ Back to topYes. A translation template (.pot file) is included in the languages folder.
Questions and support
↑ Back to topSomething missing from this documentation? Do you still have questions and need assistance?
- Have a question before you buy this extension? Please fill out this pre-sales form. Please include the name of this extension in your query.
- Already purchased and need some assistance? Get in touch with the developer via the Help Desk.