Skip to main content

Worksana Mobile App Troubleshooting Guide

Most issues in Worksana are easy to solve with a quick check or two. This guide covers the most common problems and how to fix them.

Z
Written by Zack Pierce
Updated over 7 months ago

1. Try closing and reopening the app

This is the single most effective fix.

Steps:

  • Swipe close Worksana (remove it from recent apps).

  • Reopen it.

This clears up many temporary issues.

2. I don’t see a punch-in button after logging in

Worksana requires location services to be on before you can clock in or out.

Fix (iOS):

  • Go to Settings > Privacy & Security > Location Services > Worksana

  • Set to While Using the App or Always

  • Turn on Precise Location

Fix (Android):

  • Go to Settings > Apps > Worksana > Permissions > Location

  • Set to Allow only while using the app or Allow all the time

  • Make sure Use precise location is on

Swipe close and reopen the app after making changes.

3. The text message login isn’t working

Some carriers or devices may block the text login flow.

Fix:

  • Get your username and password from your administrator

  • Use those credentials to log in instead

4. My punch button is spinning and won’t go through

Worksana works in low or no connectivity environments, but sometimes the phone detects a weak signal that isn’t strong enough to sync.

Fix:

  • Put your phone in Airplane Mode to short-circuit into Offline Mode

  • Submit your punch (it should go through right away)

  • Exit Airplane Mode when you’re done

5. Keep the app updated

We release updates often to improve performance, fix bugs, and add features.

Fix (iOS):

  • Open the App Store

  • Tap your profile icon > scroll to Worksana > tap Update

Fix (Android):

  • Open the Google Play Store

  • Tap your profile icon > Manage apps & device > Updates available > Update Worksana

Tip: Enable automatic updates on your device so you always have the latest version.

6. Watch the sync bar

The sync bar tells you if your activities have uploaded to Worksana’s servers:

  • Red: Activities have not synced yet — your administrator doesn’t see them

  • Blue: Everything is synced

Fix:

  • Leave the app open long enough for activities to sync

  • If service is poor, try again once you’re in a stronger signal area

7. I’m not receiving my meal notifications

Meal break reminders are sent from Worksana’s servers at the time set by your administrator.

Fix (iOS):

  • Go to Settings > Notifications > Worksana

  • Turn on Allow Notifications

Fix (Android):

  • Go to Settings > Apps > Worksana > Notifications

  • Ensure notifications are Allowed

Note: If you’re in a very poor network area, you may not receive the reminder right away. Worksana will retry for up to 30 minutes. After that, the system stops attempting for that shift.

8. Reporting a bug

If you think you’ve found a real bug, you can send us a detailed report right from the app.

Steps:

  1. Open the side menu (hamburger icon in the top left).

  2. Turn on the toggle for “Report an issue.” (This stays on for 3 days.)

  3. Recreate the problem in the app.

  4. Shake your phone — a report form will appear.

  5. Fill in your name, company, and a brief explanation, then submit.

This sends us a short video (app only), background code logs, and diagnostics. It helps us fix issues fast.

Important: If you don’t recreate the issue before shaking your phone, the report won’t capture it properly.

Next step: Let your administrator know you submitted a bug report so they can alert our support team.

Quick Checklist

When in doubt, try these first:

  • Swipe close and reopen Worksana

  • Check location permissions (Always/While Using + Precise On)

  • Toggle Airplane Mode if a punch won’t sync

  • Make sure the app is updated

  • Watch the sync bar (red vs. blue)

  • Check notification settings if you’re missing meal reminders

  • Report bugs through the built-in tool

Did this answer your question?