Troubleshooting
Quick fixes for the most common issues. If a problem persists, check Logs and the Dashboard for clues, and if it still isn't right, get in touch. Anything to do with the server itself is our job, not yours.
Emails or SMS are not sending
Checklist:
- Are your provider details correct? Send a test message from Settings → Email / SMS. This is by far the most common cause.
- Check Logs for the failed message and its error, then retry it.
- For email, confirm your from address domain has SPF/DKIM set up with your provider.
- Has your SMS account run out of credit? Most providers stop sending silently.
If tests pass but queued messages never leave, tell us: that points at the background task on your instance, which is ours to fix.
Mobile service says an address isn't covered
Cause: The customer's postcode is beyond your largest travel-fee tier, or the postcode could not be looked up.
Fix: Add or extend your travel-fee tiers under Settings → Mobile & Travel, and confirm your shop origin postcode is set and valid.
The drive-time ETA isn't calculating
Checklist:
- Have you set a shop origin postcode (Settings → Mobile & Travel)?
- Is Auto drive-time ETA enabled?
- Does the booking have a valid customer postcode?
If any are missing, DetailByte falls back to letting you enter the ETA manually, and the booking is otherwise unaffected. See Mobile & Travel.
A variable shows as literal text in a message
Cause: The variable was used in a template that doesn't provide it: for example a loyalty variable (like {points_balance}) in a booking email.
Fix: In the template editor, only use variables from the group that matches the template. The editor marks variables that won't work in the current template. See Templates & Automations.
A photo won't upload to a job package
Checklist:
- Is the file a supported image (JPG, PNG, WEBP)?
- Is it a reasonable size? Photos straight from a modern phone are fine; a 100MB export is not.
- Is your connection holding up? Large batches over a weak mobile signal often stall part-way: upload in smaller groups.
A customer says they never got their photos
Checklist:
- Was the package actually sent, or just built? Building it does not deliver it.
- Check Logs for the thank-you email and its status.
- Has the access window expired? Galleries stay open for the number of days set under Settings → Customer Programs → Job Packages, counted from when you sent it.
Forgot the admin password
Use the Forgot password link on the admin login, which emails you a reset link. If your email provider isn't configured yet (so no email can be sent), contact us and we will reset it for you.
Where to look first
- Logs: every email/SMS and its status.
- Dashboard: recent activity and system health.
- Notifications bell: stale drafts and overdue jobs.