View Categories

Troubleshooting

Campaign or volunteer check-in URL returns 404 #

  1. Confirm the plugin is active.
  2. Open Settings > Permalinks.
  3. Select Save Changes.
  4. Purge WordPress, host, and CDN caches.
  5. Confirm the web server permits WordPress rewrite rules.

The plugin also repairs missing volunteer check-in rules during normal operation, but server-level caching or rewrite restrictions can still interfere.

Site claim email fails #

  • Verify the Organization Profile email.
  • Verify the WordPress Site Address and WordPress Address are valid HTTPS URLs.
  • Confirm wp_mail() works.
  • Configure a transactional email provider.
  • Check outbound HTTPS access to the GiveBlocks API.

Stripe connection fails #

  • Confirm the site is claimed.
  • Confirm the selected payment mode.
  • Use the correct live or test Stripe flow.
  • Confirm the exact callback/redirect URL is authorized on the platform’s Stripe application.
  • Confirm the Stripe account has Connect enabled where required.
  • Review Stripe and platform logs for the specific request error.

Test key reports “No such API key” #

The configured Stripe test secret may be invalid, truncated, copied with placeholder characters, or belong to a different Stripe account/application. Update the Platform API environment variable with the complete test secret and redeploy the API.

Never paste a secret key into WordPress or public support messages.

Donor portal is blank #

  • Confirm the Donor Dashboard block or shortcode is on the page.
  • Confirm the page is published.
  • Purge caches.
  • Check the browser console for JavaScript errors.
  • Confirm the plugin version supports the saved block namespace.

Donor records are incorrectly grouped #

The directory groups by normalized email. Verify that each donor has the correct email and that imported records did not reuse one email across multiple donors.

Imported dates are wrong #

  • Map the correct Transaction date column.
  • Prefer ISO-formatted dates.
  • Check Settings > General > Timezone.
  • Confirm the source includes the correct year.

Net received differs from the checkout estimate #

The checkout displays an estimate. Final reports should use Stripe’s actual fee data after the transaction/webhook is processed. Confirm the webhook completed and refresh the transaction after Stripe finalizes the balance transaction.

Camera activates but the scanner collapses or stays black #

  • Confirm HTTPS.
  • Grant camera permission.
  • Close other camera-using apps.
  • Try the device’s current Chrome or Safari version.
  • Disable page optimization/minification for the check-in route.
  • Purge caches and reopen the page.
  • Confirm the QR scanner script loads successfully.

PWA install button is unavailable #

  • Confirm the manifest returns JSON.
  • Confirm the service worker returns JavaScript.
  • Confirm the service worker controls the check-in page.
  • Use the canonical /volunteer-checkin/ URL.
  • Check whether the app is already installed.
  • On iOS, use Safari’s Add to Home Screen workflow.

Email test fails #

GiveBlocks uses wp_mail(). Configure SMTP or a transactional email service, verify the From address/domain, and check the provider’s logs.

Changes require Ctrl+F5 #

This indicates caching or stale assets. Purge the WordPress, server, CDN, browser, and service-worker caches. Confirm the active plugin directory contains the current version.

Updated on July 23, 2026