Animals Not Displaying #

If your search page shows no animals (blank area, no error message, or a “no results” message), work through this checklist to identify the cause.

Debug Checklist #

1. Is the API Connected? #

1. Go to PetMatchPro > General Options.
2. Verify an Integration Partner is selected.
3. Verify the API Key is entered (and Organization ID for RescueGroups).
4. Use the API Diagnostics tool in the Tools tab to test the connection.

2. Are There Animals in Your Shelter System? #

1. Log into your shelter management system (PetPoint, AnimalsFirst, or RescueGroups).
2. Verify that there are active animal records for the method type you’re searching.
3. For type="adopt", check that animals have an “available” or “adoptable” status.

3. Is the Shortcode Correct? #

1. Edit the page and verify the shortcode is properly formatted: [pmp-search]
2. Check for typos — the shortcode is [pmp-search], not [pmp_search] or [pmpsearch].
3. If using parameters, verify they’re properly formatted: [pmp-search type="adopt"]
4. Make sure the shortcode isn’t wrapped in extra HTML tags or formatted as a code block.

4. Is the Page Published? #

1. Check that the page is published (not in draft or pending review).
2. View the page while logged out or in an incognito window to see what visitors see.

5. Are Filters Too Restrictive? #

1. If using species="...", verify the species name matches animals in your system.
2. If using exclude="...", check that you’re not excluding everything.
3. Try the shortcode with no parameters to see all animals: [pmp-search]

6. Is the Method Type Valid? #

1. Check the type parameter matches your partner and license:
   • RescueGroups: Only adopt is supported
   • lost, found, list: Require Junior license
   • preferred: Requires Preferred license, AnimalsFirst only

7. Is Caching the Problem? #

1. Clear your browser cache and hard refresh (Ctrl+Shift+R).
2. Clear any server-side cache (OPcache, LiteSpeed, CDN).
3. Try viewing the page in an incognito/private window.

See Stale Content / Cache Issues for detailed cache clearing instructions.

8. Check the Browser Console #

1. Right-click on your search page and select Inspect (or press F12).
2. Click the Console tab.
3. Look for red error messages — JavaScript errors can prevent PetMatchPro from rendering.
4. Check the Network tab for failed API requests (red entries).

9. Check for Plugin Conflicts #

1. Temporarily deactivate other plugins to see if there’s a conflict.
2. Switch to a default WordPress theme (like Twenty Twenty-Four) to rule out theme conflicts.
3. Re-enable plugins one at a time to identify the conflicting one.

Still Not Working? #

If you’ve worked through all steps above and animals still don’t display, contact PetMatchPro support with the following information:

• Your integration partner (PetPoint, AnimalsFirst, or RescueGroups)
• The exact shortcode on your page
• Any error messages displayed
• Browser console errors (screenshots)

Next Steps #

• Common Error Messages — Understand error messages
• API Connection Issues — Fix connection problems
• How to Contact Support — Get help