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

Gravity Forms Allotments Setup Guide

Updated 13 min read Gravity Forms Integrations A–Z
On this page
  1. Video walkthrough
  2. Who it is for
  3. What you need
  4. Install and activate
  5. How it differs from other tools
  6. Step 1: add your sites and plots
  7. The site map and the plot list
  8. Step 2: build the application form
  9. Step 3: set local postcodes and the waiting list order
  10. Your place on the list: the private link
  11. Step 4: offer a vacant plot to the next person
  12. One tenant per plot
  13. Step 5: tenancies and the yearly renewal
  14. Rent by plot size, shown or paid online
  15. Step 6: inspections and warning letters
  16. The public site map
  17. CSV exports
  18. Privacy
  19. Uninstall
  20. Questions

Video walkthrough

Gravity Forms Allotments: Plot Register, Waiting List & Online Plot Offers
Video setup guide: Gravity Forms Allotment & Garden Plot Manager Watch on YouTube

The Gravity Forms Allotment & Garden Plot Manager add-on runs allotments and community garden plots on your own website. You keep a register of your sites and plots with their size, features and status on a simple site map; people apply through an ordinary Gravity Forms form and join a waiting list ranked by local residents first and then by the date they applied; and each applicant can see their own place on the list with a private link. When a plot is free, one click offers it to the next person on the list with a signed link and a deadline. Accepted offers become tenancies with a yearly renewal, rent by plot size, a lapse when nobody renews, and plot inspections that send a warning letter after two low scores in a row. This guide covers installing the add-on, sites and plots, the application form, the waiting list, offers, tenancies and renewals, rent and payments, inspections, the public map, the CSV exports and privacy.

Who it is for

Allotment associations and societies, parish and town councils, housing providers with garden plots, community gardens and growing projects, schools with plots for families: anywhere a limited number of plots is let to local people for a year at a time, with more people waiting than there are plots. Instead of a register in a spreadsheet, a waiting list on paper and letters in the post, the register, the list, the offers, the renewals and the inspections all run on the Gravity Forms site you already have.

What you need

You need Gravity Forms 2.9 or newer and WordPress 6.5 or newer on PHP 7.4 or newer. The add-on makes no outside connection beyond checking gravityextra.com for your licence and plugin updates: warning letters are drawn as PDF files on your own server, and e-mails go out through WordPress like any other site e-mail.

Staff screens follow the Gravity Forms permissions. The site map, the waiting list, offers, tenancies, inspections and the CSV exports need the view entries capability; offering plots needs edit entries; the sites and plots set-up and the form settings need edit forms. The inspection page has its own capability, given to the new Allotment inspector role and to administrators.

Install and activate

  • Upload the add-on zip in Plugins → Add New → Upload Plugin and activate it.
  • Go to Forms → Settings → Allotments, enter your GravityExtra licence key and press Activate License.
  • A new menu item, Forms → Allotments, opens the staff screens, and every form gets an Allotments tab in its settings.

Without an active licence the staff screen only shows a note with a link to the licence settings, new entries do not join the waiting list, the applicant, offer, renewal and inspection pages are off, the public map prints nothing and the hourly job does nothing.

How it differs from other tools

Several GravityExtra add-ons and Gravity Forms itself touch on parts of this job, so it helps to know which one does what:

  • Gravity Forms on its own saves every application as an entry, but it has no idea of plots, sites, a ranked list, offers with a deadline or a yearly renewal, so somebody still has to keep the real register in a spreadsheet.
  • Our Waitlist add-on is a waiting list for a form that is full: when a form reaches its entry limit, new people join a list and move up when a place frees. It is the right tool for a class or an event with a fixed number of places. Allotments keeps a register of real plots on real sites, ranks the list by local residence and date, offers one particular plot to one particular person with a deadline, and then manages the tenancy for years.
  • Our Room & Roommate Allocation add-on places students or guests into beds and rooms for a term, matching roommate preferences. Allotments lets whole plots of land to tenants for as long as they keep renewing and keep the plot cultivated.
  • Our Parking Permits add-on issues numbered permits for vehicles in zones with a fixed number of spaces, for a term, a month or a year, with a warden plate lookup. Allotments has no permits: it has plots, a waiting list in priority order, plot offers, renewals and inspections.

Step 1: add your sites and plots

Open Forms → Allotments → Sites & plots set-up. Add each site with its name and address; an empty row at the bottom adds a new one. Then, for each site, fill in its plots, one row per plot:

  • Number: the plot number people know, such as 7, 12A or B3.
  • Size (m²) and whether it is a half plot. The size sets the rent band; the half-plot tick is matched against what applicants want.
  • Water, Shed and Raised beds: the features applicants see in an offer.
  • Status: Vacant, Lapsed (for example a plot that is being cleared) or Not lettable (flooded, used for compost, kept for a community bed). Plots that are Let or Offered change status only through offers, renewals and lapses, so nobody can let a plot twice by editing the register.
  • Column and Row: where the plot sits on the site map, counting from the top left. Plots without a place are added after the last row.

The site map and the plot list

Forms → Allotments → Site map & plots shows each site as a grid. Every plot is a tile with its number and size, coloured by its status: vacant, let, offered, lapsed or not lettable. Above the grid you see how many plots are in each status. Under it, the plot list shows the same plots as a table, which works with a screen reader and a keyboard: size, features, yearly rent, status, the tenant and the renewal date of a let plot, or who it is offered to and until when.

The site map for Riverside Road: a grid of 18 plots coloured by status (let, vacant, offered, lapsed, not lettable) with the plot number and size on each, counts per status, and below it the plot list with size, features, rent, status, tenant, an Offer next button on vacant plots and a link to the inspections
Forms → Allotments: the site map with status colours and the accessible plot list.

A vacant or lapsed plot has an Offer next button, and every plot links to its inspection history. When you have more than one site, links above the map switch between them.

Step 2: build the application form

Create a normal Gravity Forms form with these fields (the labels are up to you):

  • Name and E-mail. The private link, offers and renewal invitations go to this address. Each e-mail address can be on the list once.
  • Phone and Address (optional, shown to staff and in the CSV).
  • Postcode: a single line text field, or the ZIP / postal code input of an Address field. It decides the local-resident priority.
  • Preferred sites: Checkboxes, Multi Select or Drop Down. You do not need to type the choices; the add-on fills them in from your sites. Nothing ticked means any site.
  • Preferred size: Drop Down or Radio Buttons. The add-on fills in Any size, Half plot and Full plot.

Then open Form Settings → Allotments, choose A plot application (joins the waiting list) and match each field. When someone sends the form, they join the waiting list at once and receive an e-mail with a private link to their place on the list.

Step 3: set local postcodes and the waiting list order

In Forms → Settings → Allotments, list your local postcodes, one per line. Applicants whose postcode matches come first on the list; everyone else follows. Within each group people are in the order they applied. Matching works on whole postcode districts, so AB1 matches AB1 2CD but not AB10 2CD; a line such as AB3 4 matches one sector; a line of letters only, such as AB, matches the whole area; and a ZIP code matches when it starts with the line. Spaces and capital letters do not matter.

Forms → Allotments → Waiting list shows everybody in that order with their place, postcode, a Local badge, the sites and size they want and the date they applied. Someone with an open offer stays in the list, marked Offer open, without a number.

The waiting list: nine applicants in order, local residents first and then by application date, each with the e-mail address, postcode, a Local badge, the sites and plot size they want, the date they applied and their status
The waiting list: local residents first, then by the date they applied.

The confirmation e-mail has a See my place on the list button. The page it opens shows the applicant’s own place on the whole list and their place for each site they want, the date they applied, the size they asked for and whether they count as local, with a short note on how the order works. It shows nobody else’s name, place or details.

The link carries a signed token made for that one applicant and that one purpose. Changing a single character, swapping in another applicant’s reference or using a link made for something else gives an access-denied page (HTTP 403). Once the applicant has a plot, the same link tells them so.

Step 4: offer a vacant plot to the next person

On the site map, press Offer next on a vacant or lapsed plot. The add-on picks the highest-placed person on the waiting list who wants that site (or any site) and that size (or any size), and who has not already turned this plot down or let an offer of it run out. It e-mails them an offer with the plot, its size, features and yearly rent, and a deadline. The deadline is set by Days to answer an offer in the settings (14 days by default). The plot shows as Offered on the map and nobody else can be offered it at the same time.

An allotment offer on a phone: Plot 7, Riverside Road, 250 m² full plot with water, rent of sixty pounds a year, the date to reply by, and Accept the plot and Decline buttons
The offer page the applicant opens from the e-mail, with the deadline to reply.

The applicant opens the offer from the e-mail and presses Accept the plot or Decline:

  • Accept starts the tenancy at once, the plot shows as Let, the applicant leaves the waiting list and receives a welcome e-mail with the start date and the next renewal date.
  • Decline sends the plot straight on to the next eligible person. The applicant who declined keeps their place on the list and can be offered a different plot later.
  • No reply by the deadline: the hourly job closes the offer, tells the applicant (who also keeps their place) and offers the plot to the next person.

One tenant per plot

A plot can only ever have one tenant. Accepting is two guarded steps in the database: the offer can only change from open to accepted once, and only inside its deadline; then the plot can only change from offered with this offer to let once. If the same person presses Accept twice, on two devices, or two people try to accept the same plot at the same moment, exactly one tenancy is created and everyone else is told the offer is closed. Offering is serialised as well, so two members of staff pressing Offer next on the same plot never send two offers.

Step 5: tenancies and the yearly renewal

Forms → Allotments → Tenancies lists every tenancy with the tenant, the plot, the start date, the next renewal date, the rent and the status. In the settings, the Yearly renewal day (default 10-01, 1 October) is the day each year when every active tenant receives an invitation to renew, and Days to renew (default 28) is how long they have.

The invitation shows the rent for the year and a Renew my tenancy button with a signed link. A tenant who renews moves on to the next year’s renewal day and receives a confirmation. A tenancy that is not renewed by the deadline lapses the day after: the tenant is told, the plot becomes vacant on the map and you can offer it to the next person with one click. Each invitation is sent once, and a renewal link works once per year.

Rent by plot size, shown or paid online

Rent by plot size in the settings is a short list of bands, one per line: the largest size in m², a bar, and the yearly rent. The default is 125|35.00, 250|60.00 and 500|95.00, so a 100 m² half plot pays 35.00 and a 250 m² plot 60.00 in your Gravity Forms currency. The rent is shown in offers, on the plot list, in renewal invitations and on the renewal page.

  • Shown only (the default): the renewal page shows the rent and a Renew button, and tenants pay as you ask, for example at an open day or by bank transfer.
  • Paid online: build a small renewal form (a confirmation tick box is enough), add your Gravity Forms payment add-on feed to it, and in Form Settings → Allotments choose The yearly renewal form. Invitations then link to the page that shows that form, with a note about the plot and the rent. The rent of the tenant’s plot is added to the order on the server, as a line such as Allotment rent: Plot 7, Riverside Road (250 m², full plot), so the payment add-on charges the right amount whatever is changed in the browser. The tenancy renews when the payment add-on reports the payment as completed. The form refuses a visit without a valid renewal link.

The add-on does not take or refund payments itself; that stays with your payment add-on and your gateway.

Step 6: inspections and warning letters

Give the people who walk the sites the Allotment inspector role in Users → Edit. They log in on a phone and open the inspection page (linked from the staff screens; bookmark it). For each plot they choose the plot, give a cultivation score from 1 (not cultivated) to 5 (excellent), add notes and, if they like, take a photo. Photos go into the media library.

When a let plot gets its second score of 2 or less in a row in the same tenancy, the add-on e-mails the tenant a plot cultivation notice as a PDF letter: the plot, the two inspections with their scores and notes, a date four weeks ahead to bring the plot back into cultivation, and an invitation to get in touch if something is stopping them. A good score in between starts the count again.

A plot cultivation notice as a PDF letter from Riverside Allotment Society: the plot, the two inspections with low scores and the inspector's notes, a date to bring the plot back into cultivation and the committee's signature
The warning letter sent after two low inspection scores in a row.

Forms → Allotments → Inspections lists recent inspections; the link on a plot shows its whole history, newest first, with the inspector’s name, the notes, the photo and a button to download the warning letter again.

The public site map

Put the shortcode [gfal_allotment_map] on any page to show every site, or add site="1" inside it for one site (the plot list in the staff screen shows the exact shortcode for each site). Visitors see the plots as coloured tiles with their numbers, a legend, and a plot list with size, features and status. The public map never shows a tenant’s or applicant’s name, e-mail or postcode: only plot numbers and status.

CSV exports

Three exports, each from its own tab: plots (site, plot, size, half plot, features, status, rent, tenant, renewal date and map position), tenants (tenant, e-mail, site, plot, size, start date, renewal date, last day to renew, status, renewals, rent and the amount last paid online) and the waiting list (place, name, e-mail, phone, address, postcode, local, sites, size, application time, status and entry ID), in waiting-list order. Cells a spreadsheet would treat as a formula are made safe with a leading apostrophe, and every download is protected by a nonce.

Privacy

  • Applications contain personal data. Tell applicants how you use it in your own 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 a waiting applicant’s entry for good also removes them from the list.
  • Links in e-mails carry opaque signed tokens, never names, e-mail addresses or postcodes.
  • Applicants see only their own place. The public map shows plot numbers and status only.
  • Staff screens, letters and exports are open only to users with the matching Gravity Forms capability.

Uninstall

Deleting the add-on from the Plugins screen removes its seven tables (sites, plots, applicants, offers, tenancies, inspections and the lock used for offers), its options, its hourly job, the Allotment inspector role and the inspection capability. Your forms, entries and inspection photos are kept.

Questions

  • Can a tenant hold two plots? A tenant who wants a second plot applies again with the same e-mail address once their first application has become a tenancy.
  • Can I let a plot to someone who is not first on the list? No: offers always follow the published order of the list, which keeps the process fair and easy to explain to everyone who is waiting.
  • What if a tenant wants to give up a plot? They simply do not renew. The tenancy lapses the day after the renewal deadline and the plot can be offered to the next person with one click.
  • Does the waiting list work without a local area? Yes. Leave Local postcodes empty and the list is in application order.

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