GatherHearth
Find answers, setup guides, and step-by-step help.
Troubleshoot Common Setup Problems
Learn how to restore missing GatherHearth pages, confirm payment settings, check registration windows, and understand when staff actions require sign-in.
If GatherHearth is not behaving the way you expect during setup, start with the basics: confirm the plugin has created its pages, verify payment settings, and check whether the event is actually open for registration. If a check-in, payment, or admin action is unavailable, make sure you are signed in with the right WordPress account.
Check for missing GatherHearth pages
GatherHearth creates and tracks the pages it needs automatically, and existing pages are not overwritten. If a page is missing, repair the page set from the GatherHearth admin area.
- In the WordPress admin, go to GatherHearth → Pages.
- Review the list of pages and their status.
- If one or more pages are marked missing, choose Repair / Create Missing Pages.
- Return to the list and confirm the page now shows as ready.
Use this when a registration, completion, or related GatherHearth page is not available after installation or an update.
Confirm payment settings
If paid registration is unavailable, open the payment settings and make sure Square is configured.
- In the WordPress admin, go to GatherHearth → Payment Settings.
- Enter the Square application ID, location ID, and access token.
- Choose the payment mode you want to use.
- Save your changes.
After saving, the status area shows whether Square credentials are configured. If payment is still unavailable, double-check that the required Square details are present and saved.
Tip: Start in Sandbox / Testing until you have completed a test payment.
Check whether registration is open
Registration only accepts submissions when the event is published and the event registration window is open.
- Open the event in WordPress and confirm it is published.
- Check the event’s registration open and close dates or times.
- Make sure the current time is within the open window.
- Save the event if you change the schedule.
If registration has not opened yet, the registration form tells visitors to come back later. If registration is closed, the form no longer accepts submissions.
Also confirm that the event and the selected registration type still have capacity. If the event or type is full and waitlist is not available, new registrations cannot be completed.
When check-in or payment actions are unavailable
Some actions are only available for specific registration states or for the correct staff account.
- Check-in actions: If an attendee is not currently checked in, undo check-in is not available.
- Payments: Only registrations that still have an amount due can be paid.
- Waitlisted registrations: A waitlisted registration cannot be paid until it is promoted.
- Group registrations: Payment for a group is managed from the primary attendee record.
If you are trying to manage registrations or payments in the admin area, sign in with a WordPress account that has the required administrative access. Some actions are limited to staff accounts with the appropriate permissions.
If a payment session has expired
For registrations that require online payment, the payment window and checkout hold can expire. If that happens, the registration may return to the waitlist or the held spot may be released. In that case, the attendee usually needs a new registration or a fresh payment link.
Quick recovery checklist
- Repair missing GatherHearth pages.
- Confirm Square credentials in Payment Settings.
- Check that the event is published and registration is open.
- Verify the event or registration type still has capacity.
- Sign in with the correct WordPress account for staff actions.
If the problem continues after these checks, review the event setup and the registration state before trying again.
