Common Errors and Fixes

NeedBridge is an email-powered need-matching platform that connects people in need with volunteers through nonprofit organizations. This article covers the most frequently encountered errors in NeedBridge and how to resolve them. Each issue is listed with its symptom, likely cause, and recommended fix.

"This email is already subscribed"

Symptom: You try to sign up as a volunteer and see a message that your email address is already in the system.

Cause: Your email was previously registered -- either by you or by an admin who added you. You may have signed up in the past and forgotten.

Fix: You do not need to register again. Your existing subscription is active and you can still claim needs. If you are not receiving notifications, check your notification frequency settings by clicking the "Manage Preferences" link at the bottom of any previous notification email. If you need to update your areas or other details, use that same link.

Blank or Broken Email Display

Symptom: A NeedBridge email arrives but appears blank, shows garbled text, or does not render correctly.

Cause: Some email clients have difficulty rendering HTML emails, especially older desktop clients or certain webmail providers with aggressive content filtering.

Fix: Try one or more of the following:

  • Open the email in a different email client (for example, view it in a web browser if you normally use a desktop app).
  • Check if your email client has a "View as plain text" or "Load remote content" option and toggle it.
  • Forward the email to a different email address (such as a Gmail account) to see if it renders there.
  • If the problem persists across multiple emails, contact your organization's admin and let them know which email client you are using.

Invalid Email or Phone Format

Symptom: You receive a validation error when entering your email address or phone number in a form.

Cause: The system expects specific formatting and your entry does not match.

Fix:

  • Email: Make sure there are no spaces before or after the address. The format should be name@domain.com. Check for accidental characters or missing parts (like the .com or the @).
  • Phone: Enter digits only, or use the format shown as an example on the form. Avoid parentheses, dashes, or country codes unless the form explicitly asks for them. If you are unsure of the expected format, try entering just the 10-digit number.

Expired Verification or Invitation Links

Symptom: You click a link from a verification email or an invitation email and see a message that the link has expired.

Cause: Verification and invitation links are time-limited for security. If too much time has passed since the email was sent, the link is no longer valid.

Fix:

  • Verification links: Go to the login page and look for an option to resend the verification email. Click it, then check your inbox for a new email with a fresh link.
  • Invitation links: Contact the admin or coordinator who invited you and ask them to send a new invitation. They can do this from the admin panel.

"Access Denied" Page

Symptom: You try to access a page in the admin panel and see an "Access Denied" or "You do not have permission" message.

Cause: Your user role does not include permission to view that page. For example, case workers cannot access the Reports section, and coordinators can only see data within their assigned areas.

Fix: If you believe you should have access, contact your organization's admin. They can check your role and area assignments and adjust them if needed. Do not attempt to access the page through modified URLs or bookmarks from another user -- permissions are enforced at the server level.

Page Not Loading or 404 Error

Symptom: A page does not load, shows a 404 "Not Found" error, or appears stuck.

Cause: This can result from several things: a mistyped URL, a cached version of an old page, a temporary server issue, or a link to content that has been removed.

Fix:

  • Check the URL: Make sure the address in your browser is correct. Mistyped slugs or extra characters can cause 404 errors.
  • Clear your browser cache: Old cached pages can sometimes cause display issues. Clear your cache or try opening the page in a private/incognito window.
  • Try a different browser: If the page loads in another browser, the issue is likely browser-specific (an extension, cache, or setting).
  • Wait and retry: If the server is temporarily unavailable, waiting a few minutes and refreshing often resolves the issue.
  • Contact support: If the problem persists, contact your organization's admin or NeedBridge support.

Can't Find a Specific Need

Symptom: You are looking for a need you saw before but it no longer appears in the listing.

Cause: The need may have been:

  • Claimed by another volunteer and is no longer available.
  • Completed and removed from the active listing.
  • Expired because the due date passed.
  • Located in a different area than the one you are currently filtering by.
  • Cancelled by the case worker.

Fix: Check your filters -- you may have an area or category filter selected that excludes the need. If you previously received an email notification about the need, try clicking the link in that email. If the need has been fulfilled or removed, the link will typically show a message explaining that.

General Troubleshooting Tips

If you encounter an error not listed here:

  1. Refresh the page and try the action again.
  2. Clear your browser cache or try an incognito/private window.
  3. Try a different browser to rule out browser-specific issues.
  4. Check your internet connection to make sure you are online.
  5. Contact your organization's admin if the issue appears to be account or permission related.
  6. Contact NeedBridge support if the issue appears to be a system-wide problem.

Related Articles