Pet Compatibility Manager

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
  1. Download the .zip file from your WooCommerce.com account.
  2. Go to WordPress Admin > Plugins > Add New and click Upload Plugin.
  3. Choose the .zip file and click Install Now.
  4. 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.
If the My Pets page shows a “Page not found” error after activation, go to Settings > Permalinks and click Save Changes without changing anything. This refreshes the My Account page addresses.

Quick start

↑ Back to top
  1. Go to WooCommerce > Pet Compatibility > Compatibility > Category Defaults and set rules for your main categories, such as “Dog” for your dog food category.
  2. Open any product that differs from its category and set its own rules in the Pet Compatibility tab.
  3. For food and other supplies, tick Consumable and enter how many days the product lasts.
  4. Go to WooCommerce > Settings > Pet Compatibility and adjust the badge text and colors to match your theme.
  5. 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 top

Each 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:

  1. The variation’s own rules, when the customer is looking at a variation. Fields left empty on the variation come from the product.
  2. The product’s own rules, set in the Pet Compatibility tab.
  3. Category defaults, when the product has no rules of its own.
  4. 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_thresholds filter.
  • 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 top

Product rules

↑ Back to top
  1. Go to Products and edit a product.
  2. In the Product data panel, click the Pet Compatibility tab.
  3. 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.
  4. Click Update.
If a minimum is higher than its maximum, the extension swaps the two values when you save and shows a notice, so you can check the range.

Variation rules

↑ Back to top

Each 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
  1. In the product’s Pet Compatibility tab, tick Send a restock reminder after purchase.
  2. In Remind after, enter how many days the product usually lasts, for example 30 for a monthly flea treatment.
  3. 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 top

Category defaults apply rules to every product in a category that has no rules of its own.

  1. Go to WooCommerce > Pet Compatibility and open the Compatibility tab.
  2. Click Category Defaults.
  3. 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.
  4. 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 top

Bulk Assign applies rules to many products at once.

  1. Go to WooCommerce > Pet Compatibility > Compatibility and click Bulk Assign.
  2. Choose a Category, search by product name if needed, and click Filter. A check mark shows products that already have their own settings.
  3. Tick the products you want, or click Select all visible.
  4. Set Species, Life Stage, Age Range (months), Weight Range (kg), and optionally Mark as consumable with an interval in days.
  5. 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.
  6. Click Apply to Selected. A message shows how many products were updated and how many were skipped.

Attribute Manager

↑ Back to top

Go 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.
Deleting a custom value removes it from the lists, but products and pet profiles that used it are not edited automatically. Check any products that relied on it.

What customers see

↑ Back to top

My Pets

↑ Back to top

Customers 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 top

Signed-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 top

When 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 top

A 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 top

Restock reminders email customers when a supply they bought is likely running low.

  1. A customer with an account buys a product marked consumable, directly or through its category defaults.
  2. 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.
  3. 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.

Reminders are only sent for orders placed by customers with an account. Guest orders are not tracked.

Birthday emails

↑ Back to top

A 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 top

Go to WooCommerce > Settings > Pet Compatibility. Settings are split into three sections: Display, Reminders, and Birthday.

Display

↑ Back to top
SettingDefaultWhat it does
Badge on Product PageOnShows per-pet badges on single product pages.
Badge on Shop PageOnShows per-pet badges in the shop and category product lists.
Show “Unknown” BadgesOffAlso shows a badge on products with no rules, such as “Compatibility unknown for Max”.
Guest / No-Pet FilterOnShows 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 LocationBelow product nameWhere the badge appears: below the product name, below the price, before or after the Add to cart button, or manually with the shortcode.
SuitableSuitable for {pet_name}Badge text when the pet matches.
Not SuitableNot recommended for {pet_name}Badge text when the pet doesn’t match.
Unknown CompatibilityCompatibility unknown for {pet_name}Badge text when the product has no rules.
Padding6px 14pxOne to four values in px, em, or rem.
Border Width (px)10 to 10.
Border Radius (px)999999 gives a full pill shape. A small value such as 4 gives a rounded square.
Font Size (px)139 to 24.
Badge AnimationNo animationPlays once when a badge scrolls into view. Visitors who prefer reduced motion never see animations.
Per-State ColorsGreen, red, and amberBackground, text, and border color for the Suitable, Not Suitable, and Unknown states.
Accent Color#6366f1Used 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
SettingDefaultWhat it does
Enable RemindersOnSends replenishment reminder emails for consumable products.
Allow Customer Opt-OutOnLets customers turn reminders off per product from their My Pets page.

Birthday

↑ Back to top
SettingDefaultWhat it does
Enable Birthday EmailsOnSends birthday emails to customers.
Days Before Birthday7How many days before the birthday to send the email, from 0 to 30.
Include CouponOnCreates a discount coupon and includes it in the email.
Coupon TypePercentage discountPercentage discount, Fixed cart discount, or Fixed product discount.
Coupon Amount151 to 100 for a percentage coupon, or an amount in your store currency for fixed coupons. Decimals are allowed.
Coupon Expiry (days)7How many days the coupon is valid. Enter 0 for no expiry.

Emails

↑ Back to top

Both 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.

EmailDefault subjectPlaceholders
Pet Product Replenishment ReminderTime to restock for your pet!{product_name}, {site_title}
Pet Birthday EmailHappy birthday, {pet_name}!{pet_name}, {site_title}

The Quick Links on the Pet Compatibility dashboard open each email’s settings directly.

Dashboard

↑ Back to top

WooCommerce > 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 top

Shortcode

↑ Back to top

To 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 top

You 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.php and myaccount/pet-form.php
  • emails/psm-reminder.php and emails/psm-birthday.php
  • emails/plain/psm-reminder.php and emails/plain/psm-birthday.php

Filters for developers

↑ Back to top
FilterWhat it changes
psm_life_stage_thresholdsThe age in months at which a pet moves to the next life stage, per species.
psm_life_stagesThe list of life stages and their labels.
psm_species_listThe full list of species shown in the store.
psm_pet_photo_max_bytesThe 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.
Deleting the extension permanently removes your customers’ pet profiles. Deactivate it instead if you might use it again.

Frequently asked questions

↑ Back to top

Why doesn’t a product show a badge?

↑ Back to top

Check 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 top

The 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 top

Open 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 top

Check 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 top

The 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 top

The 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 top

Yes. A translation template (.pot file) is included in the languages folder.

Questions and support

↑ Back to top

Something 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.

Related Products

WooCommerce Subscriptions is a WooCommerce extension that lets customers subscribe to your products or...

Offer add-ons like gift wrapping, special messages or other special options for your products.

Use of your personal data
We and our partners process your personal data (such as browsing data, IP Addresses, cookie information, and other unique identifiers) based on your consent and/or our legitimate interest to optimize our website, marketing activities, and your user experience.