🎉 Celebrate with 10% OFF on All Products! Use Code: GFEX10 Or Buy Any 2+ Items for 30% OFF with Code: GFEX30!

Gravity Forms Pet Adoption & Foster Applications Setup Guide

Updated 13 min read Gravity Forms Integrations A–Z
On this page
  1. Who it is for
  2. What you need
  3. Install and activate
  4. How it differs from other tools
  5. Step 1: add your animals
  6. Step 2: show the animals on a page
  7. Step 3: build the application form
  8. How the apply button works
  9. Step 4: the referees’ answer form
  10. Step 5: work through applications on the board
  11. One application: hints, references and notes
  12. Reference requests
  13. Approving: one application per animal
  14. Adopted and fostered
  15. Declining and withdrawing
  16. E-mails
  17. CSV export
  18. Privacy
  19. Uninstall
  20. Questions

The Gravity Forms Pet Adoption & Foster Applications add-on runs adoptions and foster placements for your shelter or rescue on your own website. You list your animals with photos and details, visitors browse them in a grid with filters, and each animal’s page has an Apply to adopt and an Apply to foster button that opens your own Gravity Forms application form, already filled in and locked to that animal. Your team works through every application on a pipeline board, asks referees for a reference through a personal link, sees matching hints from the applicant’s home answers, and approves only one application per animal at a time. This guide covers installation, animals, the grid, the application and reference forms, the board, approvals, placements, withdrawals, the CSV export and privacy.

Who it is for

Animal shelters, rescues, foster networks, breed rescues, humane societies and small adoption charities: anyone who places dogs, cats, rabbits or other animals with new homes and wants to stop juggling spreadsheets, inboxes and paper forms. It works the same whether you have five animals or two hundred, and whether you take adoption applications, foster applications or both.

What you need

Gravity Forms 2.9 or newer, WordPress 6.5 or newer and PHP 7.4 or newer. The add-on makes no outside connection beyond checking gravityextra.com for your licence and plugin updates: photos stay in your Media Library, and e-mails go out through WordPress like any other site e-mail, so whatever mail setup your site uses also sends these.

Staff screens follow the Gravity Forms permissions. The board, applications and the CSV need the view entries capability; moving, approving, declining, adding notes and sending reference requests need edit entries; form settings need edit forms. Animals are WordPress posts, so editors and administrators can add and edit them.

Install and activate

  • Upload the add-on zip in Plugins → Add New → Upload Plugin and activate it.
  • Go to Forms → Settings → Pet Adoption, enter your GravityExtra licence key and press Activate License.
  • A new Animals menu appears in the admin, Forms → Pet Adoption opens the pipeline board, and every form gets a Pet Adoption tab in its settings.

Without an active licence the board shows only a note with a link to the licence settings, the animal grid prints nothing, animal pages are not published, and new entries are not turned into applications. Everything you entered stays in place and comes back as soon as the licence is active again.

How it differs from other tools

A few GravityExtra add-ons and Gravity Forms itself touch on parts of this job. Here is which one does what:

  • Gravity Forms on its own saves each application as an entry, but it has no idea which animal an application is for, cannot stop two people being approved for the same dog, has no list of animals for visitors to browse and keeps no reference checks or private notes per application.
  • Our Mentor Matching and Carpool Matching add-ons match people with people: mentors with mentees, drivers with riders, scored on answers both sides give. Pet Adoption is about one animal and the people who want to give it a home: the animal’s traits come from your team, the hints are advice for staff rather than an automatic match, and each animal can be approved for only one applicant at a time.
  • Our Entry Board add-on is a general kanban for any form’s entries, with columns you define. Pet Adoption has the adoption stages built in (New, References, Home visit, Approved, Adopted, Declined, Withdrawn) and adds what a generic board cannot know: the animal behind every card, its status changing on approval, one approval per animal, reference requests, matching hints and polite e-mails to the other applicants when an animal finds its home.

Step 1: add your animals

Open Animals → Add animal. The title is the animal’s name and the main text box is its story: personality, history, what kind of home would suit it. Set the featured image as the main photo, then fill in the Animal details box:

  • Species: dog, cat, rabbit, small pet, bird or other, and the breed as free text (for example Beagle mix).
  • Age in years and months. An estimate is fine. The add-on stores an estimated birth date, so the age shown on the site goes up by itself and the age filter stays right without anyone editing the animal.
  • Sex and size (small, medium, large, extra large).
  • Good with children, good with dogs and good with cats: yes, no or not known yet.
  • Energy level: low, medium or high.
  • Special needs: medication, diet or care the new home needs to know about. Leave it empty if there are none.
  • Adoption fee, shown in your Gravity Forms currency. Leave it empty to show no fee, or enter 0 to show No fee.
  • Status: Available (open for adoption and foster applications), In foster care (open for adoption applications) or Adopted (no applications). On hold is set automatically when an application is approved.
  • More photos: pick extra photos from your Media Library. They appear as thumbnails under the main photo.

Publish the animal to put it on the site. Drafts, private and password-protected animals never appear in the grid and never accept applications. The Animals list in the admin shows a photo, the species, the status and the number of open applications for each animal, with a link to that animal’s board.

Step 2: show the animals on a page

Add the shortcode [pet_adoption_animals] to any page, for example a page called Meet our animals. It shows a grid of cards with a filter form above it:

The public animal grid of Willow Lane Animal Rescue: filters for species, age, size, sex and status, Good with children, dogs and cats tick boxes, and cards with an illustration, status badge, name, breed, age, size, good-with tags and the adoption fee
The [pet_adoption_animals] grid with its filters. Every card is a link to the animal’s page.
  • Filters: species, age group (baby under 1 year, young 1–2, adult 3–7, senior 8 and over), size, sex, status, and Good with children, dogs and cats. They work without JavaScript and keep their values in the address, so a filtered list can be bookmarked or shared.
  • Cards: the main photo, the status, the name (a link to the animal’s page), species, breed, age, sex and size, the animals it is good with, and the fee.
  • Accessible: every filter has a visible label, cards are a list of articles with a heading, photos have text alternatives (Photo of Biscuit), the number of results is announced to screen readers, and everything works with a keyboard.

Shortcode options: per_page (default 12), status (which statuses to show, default available,fostered,on_hold; adopted animals are left out unless you add adopted, for example on a Happy endings page) and filters="no" to hide the filter form. Example: [pet_adoption_animals status="adopted" filters="no"].

Step 3: build the application form

Create a normal Gravity Forms form for applications. You can use one form for both adoption and foster, or one form for each. Add these fields (the labels are up to you):

  • A Hidden field for the animal ID (required). The apply button fills it in.
  • A Single Line Text field for the animal’s name. It is filled in and read-only on the form.
  • If one form takes both kinds: a Radio Buttons field such as I would like to with the choices Adopt and Foster.
  • The applicant’s name, e-mail and phone.
  • Home questions for the matching hints: children at home, dogs at home, cats at home and a garden or yard (yes / no radio buttons work best; a number of children also works), and hours alone on a typical day (a Number field).
  • Up to two referees, each with a name and an e-mail field.
  • Anything else you want to ask: housing, landlord permission, experience, other animals, vet details. The add-on leaves those fields alone; you read them in the entry as usual.

Then open Form Settings → Pet Adoption, choose An adoption or foster application, set the application type (Adoption, Foster, or Asked on the form) and match each field. Put the form on a published page. The add-on finds the first published page that shows the form; if you use another page, enter its address in Page with this form.

The adoption application form opened from Biscuit's page: a note saying You are applying to adopt Biscuit, the animal name filled in and read-only, Adopt chosen, and the applicant's details, home questions and two referees
The application form opens filled in and locked to the animal.

How the apply button works

Each animal page shows the animal’s photos and details with an Apply to adopt button, and an Apply to foster button while the animal is available. The button opens your application page with the animal’s ID and the type in the address. The form then shows a note such as You are applying to adopt Biscuit with a small photo, fills in the hidden ID and the read-only name, and chooses the type for the applicant.

Everything is checked again on the server when the form is sent. The animal ID must be a number that belongs to a published animal, and the animal must take that kind of application right now: an animal on hold or adopted takes none, an animal in foster care takes adoption applications only. A changed or made-up ID, an ID that belongs to a page or post, a draft animal or the wrong type is refused with a clear message and nothing is saved. The animal’s name on the saved entry always comes from the server, so editing the read-only field in the browser changes nothing.

Step 4: the referees’ answer form

Create a second, short form for referees: their name, their e-mail address and a few questions, for example how long they have known the applicant and whether they would trust them with an animal. In its Pet Adoption settings choose The referees’ answer form and match the e-mail field. Put it on its own published page, for example Give a reference, and leave that page out of your menus.

The page only works through a personal link. Somebody who opens it without a valid link, or submits it without one, is turned away.

Step 5: work through applications on the board

Forms → Pet Adoption shows every open application on a board with the columns New, References, Home visit and Approved. Tick Show closed to add a column with adopted, fostered, declined and withdrawn applications. Choose an animal at the top to see only that animal’s applications: the per-animal board is the easiest way to compare the people who want the same dog.

The pipeline board in Forms, Pet Adoption: columns New, References, Home visit and Approved with application cards showing the applicant, adoption or foster, the animal, the date, matching hints and references answered
Forms → Pet Adoption: the pipeline board, here for all animals.

Each card shows the applicant, whether it is an adoption or a foster application, the animal (on the overall board), the date, the matching hints that need attention and how many references have been answered. A coloured edge shows the most serious hint at a glance. Click the name to open the application.

One application: hints, references and notes

One application: the applicant and stage, matching hints in red, amber and green, the home answers, the references with one answer shown, private staff notes, the animal and the next-step buttons
One application with matching hints, references, private notes and the next steps.
  • Matching hints compare the home answers with the animal’s details. Red means a conflict worth a conversation (children at home but the animal is not good with children; a cat at home but the animal is not good with cats; a high-energy animal left alone eight hours or more). Amber means something to check (not tested with dogs yet, no garden for a high-energy dog, special needs). Green means a good fit. Hints never decide anything and never reach the applicant; they help you prepare the home visit.
  • Home answers: children, dogs, cats, garden and hours alone, as given on the form. The full entry with every other answer is one click away.
  • References: each referee named on the form, whether they have been asked and their answers once they reply.
  • Staff notes: private notes for your team, with the author and time. They are never shown to the applicant, never shown on the site and not included in the CSV.
  • Next step: move the application between New, References and Home visit, approve it, mark it adopted or fostered, decline it with a reason, or withdraw it when the applicant asks you to.

Reference requests

Press Send reference requests on an application. Each referee receives an e-mail that says who named them and for which animal, with a personal Answer the questions button. An application in New moves to References at the same time. Pressing the button again sends a reminder to referees who have not answered.

Each link is signed for one referee and one purpose. The add-on refuses (with the HTTP status 403 and a short explanation) a link that has been changed, a link used by somebody else (the e-mail typed on the form must be the address the link was sent to), a link that has already been answered, and an answer sent without a link. A valid answer is attached to the application and shown under References.

Approving: one application per animal

When you press Approve, the add-on reserves the animal for that application with a single conditional update in the database: the reservation only succeeds if no other application holds the animal. The animal’s status changes to On hold, its page stops offering apply buttons, new applications for it are refused, and the applicant receives a Good news e-mail with their withdraw link.

If a colleague approves another application for the same animal, even at the very same moment, only one approval can win; the other gets the message Another application for this animal is already approved. To approve someone else, first decline or withdraw the approved application: the animal goes back to the status it had before (available or in foster care) and the other applications are still there.

Adopted and fostered

When the animal goes home, open the approved application and press Mark as adopted (or Mark as fostered for a foster application). The animal’s status changes to Adopted or In foster care, and the other open applications are closed with a polite e-mail that thanks the applicant, explains that the animal has found a home and invites them to look at the other animals. For a foster placement only the other foster applications are closed: adoption applications stay open, because an animal in foster care can still be adopted.

Adopted animals leave the grid (unless you show adopted animals on purpose) and stay in your Animals list. If an adoption does not work out, set the status back to Available in the animal’s details box and it is listed again.

Declining and withdrawing

  • Decline needs a reason, which the applicant receives with a kind standard message. Write it for them.
  • Withdraw (applicant asked) closes the application without a reason when the applicant tells you they have changed their mind.
  • Applicants can withdraw themselves. The thank-you e-mail and the approval e-mail contain a personal withdraw link. It opens a page that asks first; the application is only withdrawn when they confirm. A changed link is refused with HTTP status 403.
  • Declining or withdrawing an approved application releases the animal straight away.

E-mails

The add-on sends these e-mails through WordPress, signed with the shelter or rescue name from Forms → Settings → Pet Adoption: a thank-you when an application arrives (can be switched off), reference requests, approval, decline with your reason, the polite an update about message when the animal goes to someone else, and a confirmation after a withdrawal. Use Gravity Forms notifications on the form for staff alerts about new applications. Developers can change any of the add-on’s e-mails with the gfpetadoption_mail filter.

CSV export

Download CSV on the board exports the applications of the animal you are looking at (or all of them): reference number, date, animal, adoption or foster, stage, name, e-mail, phone, the home answers, the hint codes and the most serious level, references answered, the closing reason and the entry ID. Cells that start with =, +, - or @ are made safe for spreadsheets. Staff notes are not exported.

Privacy

  • Public pages (the grid, animal pages, the application and reference pages) show animal details only. They never show applicant names, contact details, home answers, references or notes.
  • Links in e-mails carry opaque signed tokens, never names or e-mail addresses. Withdraw and reference pages are marked noindex, are not cached and send no referrer.
  • Applications contain personal data. Describe how you use it in your privacy notice and keep entries only as long as you need them; the Gravity Forms personal data tools and entry deletion work as usual. Deleting an entry for good also deletes its application, notes and references and releases the animal if it was on hold for it.
  • Animals are not added to the public WordPress REST API.

Uninstall

Deleting the add-on from the Plugins screen removes its four tables (applications, references, notes and the per-animal hold), its options and cached page look-ups. Your forms, entries and animal posts are kept.

Questions

  • Can one form take adoption and foster applications? Yes: set the application type to Asked on the form and add the I would like to radio buttons.
  • Can people apply without an animal in mind? The application form needs an animal. For general enquiries use a separate form without the Pet Adoption setting.
  • Can two people be approved for the same animal? No. One approval per animal at a time is built in, even if two people press Approve together.
  • Do the hints reject anyone? No. They are advice for your team only and never reach the applicant.
  • Can I take a fee online? The fee is shown on the animal’s page. Collecting it stays with you, for example at the handover or with a separate Gravity Forms payment form.
  • Does it work with my theme? The grid and animal pages use plain HTML and a small stylesheet that follows your theme’s fonts.

Still need help?

Our support team answers tickets every day, usually within a few hours.

0
0
Your Cart
Your cart is emptyReturn to Shop
🔥 FREQUENTLY BOUGHT TOGETHER
Complete Combo & Save 40%!
ITEM IN YOUR CART
Gravity Forms Klaviyo Add-on
$39.00/yr
+
🎁 RECOMMENDED ADD-ON SAVE 40% OFF
Original Price: $39.00/yr
Bundle Special Price: $23.40/yr