Common Issues
Solutions to frequently encountered problems in PurposeTech – from volunteer signup to admin portal issues.
Volunteer signup issues
"One or more of your selected shifts are no longer available"
Either someone else booked the last space while the volunteer was filling in the form, or their hold ran out. Selected shifts are held for 10 minutes while a volunteer registers, and an unconfirmed hold is released after that.
Solution: Go back to the shift selection page, choose a different shift or site, and complete signup. If everything in the area is full, they may be offered the waitlist.
For admins: If this keeps happening on popular shifts, raise the number of volunteers you want for the shift, or switch on the waitlist under Volunteers > Waitlist (Waitlist Settings). Volunteers are offered the waitlist when the whole area is full.
Volunteer didn't receive a confirmation email
After signing up, volunteers get a sign-in link to confirm their booking. The welcome and shift confirmation emails follow.
If they didn't receive it:
- Check spam/junk folder – this solves most cases, especially for first-time volunteers
- Check the Promotions tab – Gmail often routes these emails there
- Check the email address on the volunteer's record under Volunteers – typos are common
- Check Messaging > Email History – search by the volunteer's email address to see whether the email was sent, delivered, bounced or opened
- Check the template – in Messaging > Email Templates, open the template and look at its Statistics and History tabs. Confirm the template is enabled for this campaign
The most common cause of "I didn't get an email" is the volunteer checking the wrong inbox. If they signed up with jane@gmail.com but are checking jane@work.com, they won't find it. Check the address on their record first.
Volunteer shows as "Unverified"
The volunteer registered but has not yet clicked the sign-in link in their email, which is what confirms their booking.
Why this happens:
- They may not have checked their email
- The email went to spam
- They entered the wrong email address
- A corporate email filter or security scanner opened or blocked the link (see Login & Authentication)
What to do:
- Check the email address is correct
- Ask the volunteer to request a new sign-in link from the campaign site
- If the volunteer is present (for example, on event day), a coordinator can add them directly from the roster. Volunteers added by a coordinator are confirmed straight away
An unconfirmed booking is only held for 10 minutes. After that the space goes back to the pool.
Duplicate volunteer registration
If a volunteer signs up with an email that already has a record:
- PurposeTech recognises the email and sends a sign-in link to the existing record
- Their existing bookings are kept
- New bookings are added to the same record
What if they signed up with different emails? Use the Merge Tool to combine both records. Shift bookings, campaign records, feedback and email history move to the record you keep.
Volunteer can't complete registration on mobile
If volunteers report the signup page not working on mobile:
- Check browser compatibility – PurposeTech works in current versions of Safari, Chrome, Firefox and Edge
- Disable ad blockers – some ad blockers interfere with form submissions
- Check connectivity – poor mobile reception can cause timeouts during registration
- Check password protection – if the campaign is still password protected (under Settings > Domains), they need the password
Volunteer wants to change their personal details
Volunteers can update their details on the My details page of the campaign site after signing in, but their login email is read-only. To change a login email, an admin or coordinator updates it on the volunteer's record under Volunteers.
Shift management issues
Can't add more volunteers to a shift
The shift has reached the number of volunteers you set for it. Options:
| Option | How | When to use |
|---|---|---|
| Raise the number | Edit the shift and increase the desired volunteers | When you genuinely need more people at that time and site |
| Waitlist | Volunteers on the waitlist are phoned and placed when a space opens (Volunteers > Waitlist) | When the area is full but cancellations are likely |
| Move a volunteer | Use Move volunteer on the roster to shift someone to a less crowded time or site | When other shifts have space |
Volunteer can't cancel their shift
Volunteers cancel their own shifts from the campaign site while signed in. If they are having trouble:
- Make sure they are signed in (they need to use the link or code sent to their email)
- Check the registration cutoff under Settings > Campaign Settings. With a per-shift cutoff, volunteers can no longer change a shift within the cutoff period before it starts (48 hours by default). With a fixed cutoff, changes close on that date
- An admin or coordinator can remove the volunteer from the roster on their behalf
Shifts not showing on the campaign site
If shifts aren't visible to volunteers, check these in order:
| Setting | Where to check | What it should be |
|---|---|---|
| Shift visibility | Edit the shift | Display on website = Yes |
| Site visibility | Edit the site | Display on website = Yes |
| Area visibility | Edit the area | Display on website = Yes |
| Password protection | Settings > Domains | Off once you are ready to go public, or the volunteer has the password |
| Registration cutoff | Settings > Campaign Settings | Not yet passed |
| Full sites | Find shifts page | Full sites are hidden by default (campaign setting Hide full locations by default), and visitors can show them with the "Only show locations with available shifts" toggle. A site marked Show full also displays as full |
If the area is hidden, all of its sites and shifts are hidden too, even if their own settings say visible.
Shifts showing the wrong time to volunteers
Check the Timezone under Settings > Campaign Settings. Shift times are shown in the campaign's time zone.
Volunteer appears in the wrong shift
If a volunteer is in a shift they didn't sign up for:
- Check whether an admin or coordinator moved them with the Move volunteer tool
- Open the volunteer's record under Volunteers. The side panel has an activity timeline with their sign-ins and actions
Roster issues
Coordinator can't see their site
Coordinators work from the roster on the campaign website. An area coordinator sees the areas they are assigned to, on the days they are assigned. A site coordinator sees the shifts they are assigned to. If a coordinator reports a missing site:
- Check their role under Volunteers (Area Coordinator or Site Coordinator)
- Check the assignment: the area's Coordinators tab (including the day), or the site's Coordinators tab
- Try having them sign out and back in so their session picks up the change
If someone also uses the admin portal, remember it is a separate account with a separate sign-in. See Login & Authentication.
"Add volunteer" button is disabled
This happens when:
- The shift already has its desired number of volunteers. Raise the number on the shift to open more slots
- The site is set to Cancel only (coordinators who are not admins can't add people to it)
Roster data not updating
The roster loads its data when you open the page. If changes made by another user aren't appearing:
- Refresh the page – pull to refresh on mobile, or F5/Cmd+R on desktop
- Check connectivity – poor reception can prevent data loading
Email delivery issues
Volunteers not receiving emails
Start with the most common causes:
- Spam/junk folder – the single most common issue
- Gmail Promotions tab – Google often routes these emails to Promotions, not Primary
- Wrong email address – check for typos on the volunteer's record
- Corporate email filters – corporate mail systems may block emails containing login links
- Full mailbox – the recipient's mailbox is full (soft bounce)
- Invalid email – the email address doesn't exist (hard bounce)
To investigate:
- Go to Messaging > Email History and search by email address, subject or tag. You can filter by event type (for example delivered, bounced or spam complaint) and time range
- Open Messaging > Email Templates, select the template, and check its Statistics tab
High bounce rate
| Bounce type | Cause | Action |
|---|---|---|
| Hard bounce | Invalid email address (doesn't exist) | Correct the email address on the volunteer's record |
| Soft bounce | Mailbox full or server temporarily unavailable | Often clears on its own |
| Spam complaint | Recipient marked the email as spam | Filter Email History by spam complaints to see who, and contact support@purposetech.io if you need help |
A high bounce rate after a CSV import usually points to old or invalid email addresses in the file. Clean the list before importing again.
Emails going to spam
Emails are sent through Postmark. If volunteers report emails landing in spam:
- Ask them to check junk/spam and mark the email as "Not spam"
- Ask them to add your sender address to their contacts
- Check your sender address – an Owner can change the address and name emails go from under Settings > Campaign API Keys. A new sender address has to be confirmed through Postmark before it is used
- Avoid spam trigger words in subject lines – "FREE", "ACT NOW", "URGENT" can trigger filters
- Contact support@purposetech.io if the problem persists
Email sent but volunteer says they didn't get it
- Check Messaging > Email History – did the email actually send?
- If it shows as delivered, the email reached their mail server. The issue is on their end (spam filter, wrong inbox)
- If it shows as bounced, the email couldn't be delivered – check the bounce reason
- If you can't find it at all, check that the template is enabled and that its schedule is set. On the reminder templates, the unscheduled-emails check lists volunteers who have shifts but no reminder scheduled (Owners only)
Salesforce sync issues
Salesforce sync is set up with the PurposeTech team, and Owners then manage it under Settings > Salesforce Sync.
Sync is not running
- Check that the sync is switched on for this campaign under Settings > Salesforce Sync, and that the Salesforce campaign ID is the right one (18 characters)
- Look at the sync status page (Volunteers > Sync) to see the most recent sync steps and whether any are stuck or failed
- If the Salesforce connection has expired, contact support@purposetech.io to re-authenticate it
Records not syncing
If specific records aren't appearing in the other system:
- Check Sync Conflicts for an error on those records
- Check the sync window in the Salesforce Sync settings. If one is set, only shifts and area-coordinator assignments inside the window are synced
- Check whether the one-way (Salesforce to PurposeTech) option is switched on. If it is, PurposeTech records won't be written back to Salesforce
Which fields sync is fixed by PurposeTech and can't be changed in the settings.
Sync conflicts piling up
Each conflict shows the record, an error message and a status of Error, Resolved or Ignored. Open a conflict to read the message, fix the underlying record in Salesforce or PurposeTech, then choose Resolve Conflict. Several conflicts with the same message usually point to one underlying data problem, so fix the cause and not each record.
You can find conflicts under Volunteers > Sync or Settings > Sync Conflicts.
Admin portal issues
A menu item or page is missing
Admin access has two roles. Volunteer Admins can use Volunteers, Reports, Messaging, Team Members (to view and invite) and AI Usage. Owners can also use Design, Settings, Domains and Activity Map, create campaigns and tenants, duplicate campaigns, create custom email templates and use Segment send. If you can't see something, ask your Owner to check your role under Organisation > Team Members.
Can't switch tenants or campaigns
Use the tenant and campaign selector in the top bar. It lists the tenants and campaigns you have access to. Creating a new tenant or campaign, or duplicating one, needs the Owner role.
Settings changes not taking effect
Some settings (branding, email templates, header/footer) may take a moment to show on the campaign site:
- Hard refresh the page – Cmd+Shift+R (Mac) or Ctrl+Shift+R (Windows)
- Clear your browser cache – cached styles or templates may show old values
- Try a private window – this rules out cache issues
- Wait a few minutes – some changes, such as a new custom domain, take time to take effect
Admin portal loading slowly
- Check your internet connection
- Try a different browser – some browser extensions can slow things down
- Narrow what you are looking at – use filters or search on large tables
Can't find a volunteer
If you're searching for a volunteer and can't find them:
- Search by email – more reliable than name search
- Check the campaign – the Volunteers list has a Current campaign toggle. Make sure you are looking at the right campaign
- Try a partial name (for example "jane" instead of "Jane Smith")
- Check your filters – role, tag, feedback and shift filters narrow the list. The AI Search box turns a plain-English description into filters
Still stuck?
If you can't find a solution here:
- Browse the FAQ for quick answers to common questions
- Check the specific guide for the feature you're using
- Contact PurposeTech support at support@purposetech.io
- Visit our Support page to submit a request