GatherHearth

KNOWLEDGE BASE

GatherHearth

Find answers, setup guides, and step-by-step help.

GatherHearth›Publish Registration Pages and Shortcodes

Publish Registration Pages and Shortcodes

Learn which public pages GatherHearth creates automatically and how to place the plugin’s shortcodes on WordPress pages for event listings, registration, completion, registration lookup, and check-in.

GatherHearth includes the public pages and shortcodes you need to list events, collect registrations, show the post-registration confirmation page, let attendees look up their registration, and support check-in. In most sites, you can let GatherHearth create the required pages automatically, then place the shortcodes where you want them to appear.

What GatherHearth creates for you

When GatherHearth is set up, it tracks the pages it needs and can create any missing ones. Existing pages are not overwritten. You can review the pages it is using and repair missing ones from the GatherHearth admin area.

To review or repair the pages

  1. Go to GatherHearth in your WordPress dashboard.
  2. Open Pages.
  3. Check the status table to see which pages are ready and which are missing.
  4. If a page is missing, choose Repair / Create Missing Pages.

After that, GatherHearth will keep using the page assignments it has already stored. If a page already exists, it is left as-is.

Available shortcodes

Use these shortcodes on WordPress pages or in content blocks that accept shortcodes.

  • [gatherhearth_events] — shows a list of published events.
  • [gatherhearth_register] — shows the registration form for a specific event.
  • [gatherhearth_complete] — shows the completion page after registration or payment.
  • [gatherhearth_my_registration] — lets an attendee look up their registration.
  • [gatherhearth_checkin] — provides the check-in view.

Show the event list

Use the event list shortcode on a page where you want visitors to browse upcoming published events.

  1. Create or edit a WordPress page.
  2. Insert [gatherhearth_events] into the page content.
  3. Publish or update the page.

The page displays published events in a grid with a registration link for each event.

Show a registration form for a specific event

Use the registration shortcode on the page where attendees should register for one event.

  1. Open the page where you want the registration form to appear.
  2. Add [gatherhearth_register].
  3. Save the page.

You can also target a specific event by including the event in the shortcode, or by sending visitors to the registration page with the event already selected. This is useful when you want to link directly from an event listing or another event page.

The form includes the attendee details GatherHearth requires, plus any event-specific questions you have added to the event.

When registration is available

GatherHearth only shows the active registration form when the event is available for registration. If registration has not opened yet or has already closed, visitors see a message instead of the form.

Show the completion page

After someone registers, GatherHearth sends them to the completion page. This page can show a confirmation message, a waitlist message, or a payment prompt depending on the registration.

In normal use, you do not need to place this shortcode manually. If you do create a custom page for it, use [gatherhearth_complete].

Let attendees find their registration

Use the registration lookup shortcode to give attendees a way to retrieve their registration details.

  1. Create a page for registration lookup.
  2. Add [gatherhearth_my_registration].
  3. Publish the page.

Visitors can use their registration number and email address to view their registration.

Use the check-in view

Add the check-in shortcode to the page you want to use for event check-in.

  1. Create or edit the check-in page.
  2. Insert [gatherhearth_checkin].
  3. Publish the page.

This page is intended for checking attendees in at the event.

Direct links to registration

GatherHearth also supports linking directly to a registration page for a specific event. This is helpful when you want a button on an event listing or a custom landing page to take visitors straight to the correct registration form.

One common pattern is to place the event list on a page, then link each event’s registration button to the registration page with the event selected.

Tips for a smooth setup

  • Use one page for your event list and another page for registration if you want a cleaner attendee flow.
  • Review the Pages screen after updating or reinstalling the plugin so you know which pages GatherHearth is using.
  • If a public page is missing, use the repair option before recreating it manually.

Related tasks

  • Set up your events before publishing the event list.
  • Review registration types and event-specific questions before sending attendees to the registration page.
  • Check payment settings if any registration type requires payment.
Powered by StoneCreek Docs