> For the complete documentation index, see [llms.txt](https://help.allwage.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.allwage.com/fundamentals/allwage-employee-self-service-app.md).

# AllWage Employee Self-Service App

Your employees clock in and out on their own phones, free, with no data and no airtime, even without signal, and with accurate GPS on every clock.

The **AllWage app** is AllWage's own app for employees, on Android and iPhone. Employees clock in and out on their own phones, and it costs them **no data and no airtime** on all major South African networks. It works with no signal and takes an accurate GPS location on every clock. It's **free** for your business and for your employees.

Clocking is the first thing the app does. More self-service features will be added to the same app over time.

{% embed url="<https://www.youtube.com/watch?v=yqGgQ8QB9sM>" %}
Signing in to the AllWage app
{% endembed %}

**What this page covers:**

* Why the AllWage app is the best way for employees to clock on their own phones
* What employees need before they can sign in
* How to choose which employees can use the app
* How employees sign in and clock
* How to manage employees' phones, and check for clocks still on phones before payroll
* Answers to common questions

**Who this is for:**

Managers, HR and payroll administrators who set up and run their AllWage portal.

## Why Use the AllWage App

### Free, with No Data and No Airtime

The app is free for your business and for your employees. On all major South African networks, **clocking costs your employees no data at all**. They can clock even with no airtime and no data bundle.

That removes the most common reason for a missed clock: "I had no data." No more excuses, and no more chasing missed clocks on payday.

{% hint style="info" %}
On smaller networks the app uses very little data, about 2 MB a month. Downloading the app (about 6 MB) uses data, so we recommend setting employees up on your Wi-Fi. See [#getting-employees-onto-the-app](#getting-employees-onto-the-app "mention").
{% endhint %}

### Clock With No Signal

Out in the field, on the road or in a dead zone? Employees clock anyway. Each clock is saved on the phone straight away and sent automatically as soon as the phone has signal again, with its original time and location.

* Clocks stay on the phone until AllWage confirms it has received them.
* Employees always see where they stand: **All clocks sent**, or how many clocks are still waiting to send.

### Clock Anywhere, With Accurate GPS

Employees can clock wherever their work takes them, and every clock in **and** out carries an accurate GPS location:

* The location must be accurate to within **50 metres** and taken at the moment the employee taps. If the phone can't find a good enough location yet, the clock buttons wait until it can.
* There's **no picking a spot on a map**. The location always comes from the phone's GPS.
* **We check every location for GPS spoofing**, and record the result with the clock.
* Clocks are matched to your sites automatically from the GPS location, if you use [Regions, Sites and Geofences](https://help.allwage.com/fundamentals/regions-sites-and-geofences.md).

### Native Apps Give More Control

The AllWage app is purposely built for **Android** and **iPhone** by AllWage. Because we built the app, we control how the location is read, how accurate it must be and how it's checked. A chat app can't give us that control.

The same applies to time. **Changing the date or time on the phone has no effect** on the clock time, so clock times are always right.

### One Employee, One Phone

Each employee's account is locked to their own phone. Nobody can clock for them from another phone. Moving the account to a new phone needs a setup code from a manager.

### Fast and Simple

Open the app, choose the activity, tap. Done in seconds. The app is designed for budget phones, with large buttons and clear text that's easy to read outdoors.

### How It Compares to WhatsApp Clocking

|                           | WhatsApp clocking                                                                 | AllWage app                              |
| ------------------------- | --------------------------------------------------------------------------------- | ---------------------------------------- |
| Data cost to employees    | Uses their own data                                                               | None on all major South African networks |
| Works with no signal      | No                                                                                | Yes                                      |
| Location                  | Shared by hand in a chat, and relies on how reliably WhatsApp shares the location | Read by the app on every clock           |
| GPS spoofing check        | No                                                                                | Yes                                      |
| Changing the phone's time | —                                                                                 | Has no effect on the clock time          |
| Account tied to           | A phone number                                                                    | One phone                                |

{% hint style="info" %}
The AllWage app is an alternative to WhatsApp clocking, with the added benefits above. Payslips, leave and the other WhatsApp self-service features stay on WhatsApp.
{% endhint %}

## Before You Start: What Employees Need

Each employee needs:

* **A smartphone:** an Android phone running Android 8 or newer, or an iPhone running iOS 17 or newer.
* **Their full ID, passport or asylum seeker permit number** captured on their employee record. The number they enter in the app must match it exactly.
* **A mobile number that can receive an SMS** captured on their employee record. Their sign-in code is sent by SMS to this number.

These are the same details used for WhatsApp registration. To capture or check them, see [WhatsApp Employee Integration](https://help.allwage.com/modules/payroll/employee-information/whatsapp-employee-integration.md#capturing-employee-details-for-whatsapp-registration).

{% hint style="success" %}
**Already registered on WhatsApp?** Then the employee's details are already captured. If they also clock on WhatsApp, no further setup is needed: they can download the app and sign in straight away. If they're registered on WhatsApp but don't clock there, turn on **Clock In/Out** for them first (see [#choosing-who-can-use-the-app](#choosing-who-can-use-the-app "mention")).
{% endhint %}

{% hint style="warning" %}
The app checks the ID, passport or asylum seeker permit number. An employee who can register on WhatsApp may still be unable to sign in to the app if their number was captured with a mistake. Check the numbers before your employees sign in.
{% endhint %}

## Choosing Who Can Use the App

Every AllWage profile can use the app. There's one setting, **Clock In/Out** on the **Employee Self-Service Features** page. It decides whether an employee may clock themselves on their own phone, on the AllWage app and on WhatsApp alike. If Clock In/Out is on for an employee, they can sign in to the app and clock. If it's off, they can't use either.

Clock In/Out is off unless you've turned it on.

{% hint style="success" %}
**Employees who already clock on WhatsApp can use the app straight away.** They just download it and sign in.
{% endhint %}

To let employees use the app, turn on **Clock In/Out** for them, either for everyone or for selected employees:

* **For all employees:** go to [**Settings > Employee Self-Service Features**](https://app.allwage.com/#/settings/whatsapp-features), enable **Clock In/Out** and click **Save**.
* **For selected employees:** on the employee list, select the employees, click **Manage** and choose **Manage self-service permissions**, then set Clock In/Out to **Enable**.

Both are explained step by step in [Employee Self-Service Features](https://help.allwage.com/modules/whatsapp/whatsapp-feature-permissions.md).

**If you don't want employees clocking themselves,** leave Clock In/Out off, or turn it off for the employees concerned. Their manager clocks them, or they use a fixed device.

{% hint style="info" %}
Turning **Clock In/Out** off for an employee stops them clocking on the app as well. Their phone stays linked, and no clock is lost. Any clocks the phone captured after the switch-off are sent again automatically once Clock In/Out is back on.
{% endhint %}

## Getting Employees onto the App

### Step 1: Check Who Is Ready

1. Navigate to [**Manage > Employees**](https://app.allwage.com/#/system/employees/manage).
2. From the **Column Presets** menu, select **AllWage app**.
3. Check the **App status** column:

| App status          | What it means                                                                     | What to do                                                                                                              |
| ------------------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Ready**           | Everything is in place. The employee hasn't signed in yet                         | Send them the app (Step 2)                                                                                              |
| **Linked**          | The employee has signed in on their phone                                         | Nothing                                                                                                                 |
| **Missing details** | No ID number or no mobile number is captured                                      | Capture the missing details                                                                                             |
| **Needs attention** | The mobile number is also on another employee's record with a different ID number | Make sure each employee has their own mobile number. If the other record isn't in your profile, contact AllWage support |
| **Clocking off**    | Clock In/Out is off for this employee                                             | Turn on Clock In/Out (see above)                                                                                        |
| **Removed**         | The employee's phone was removed                                                  | They can sign in again with a setup code (see [#new-phone](#new-phone "mention"))                                       |

### Step 2: Send the App

Send employees to [**allwage.com/app**](https://www.allwage.com/app). The page shows the right download for their phone, whether it's an Android phone or an iPhone.

**Print the poster for your notice board.** Open the [AllWage app poster](https://www.allwage.com/app/poster) and click **Print poster**. It's an A4 poster with a large QR code. Employees scan it with their phone's camera to open allwage.com/app, or type the address into their phone's browser. Put it up where employees gather, for example next to the clocking point or in the canteen.

{% hint style="info" %}
**The AllWage app is small.** On Android, it's about **6 MB** to download and uses about **20 MB** of storage once installed, so it fits on entry-level phones. If the phone says there isn't enough space, see [#the-phone-doesnt-have-enough-space-to-install-the-app](#the-phone-doesnt-have-enough-space-to-install-the-app "mention").
{% endhint %}

### Step 3: The Employee Signs In

{% embed url="<https://www.youtube.com/watch?v=yqGgQ8QB9sM>" %}
Signing in to the AllWage app
{% endembed %}

1. The employee opens the app and reads the short welcome page.
2. They enter their **ID, passport or asylum seeker permit number** (full number or just the last 6 digits) and their **mobile number**.
3. AllWage sends a 6-digit code by SMS to the mobile number on their record. On most phones the code fills in by itself, or is offered above the keyboard.
4. The phone is linked, and the employee is ready to clock.

Signing in is a once-off. From then on, the employee just opens the app and clocks.

{% hint style="success" %}
**Tip: set your team up together.** Run a short session on your Wi-Fi so nobody spends their own data on the download. Hold it where there is mobile signal, because the sign-in code comes by SMS. Finish outdoors, where phones find their location fastest, so everyone can make their first clock on the spot. Refresh the employee list to watch each employee's status change to **Linked**.
{% endhint %}

### Sign-in Messages

If the app can't sign an employee in, it says why. Each message has a short code below it for support, for example **E:RATE\_LIMITED**. Most problems are fixed on the employee's record, not on the phone.

| The app says                                                                                          | What it means                                                                                                                              | What to do                                                                                                                                                                                                                                                                                                                        |
| ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "Check your mobile number. For a number outside South Africa, start with + and the country code."     | The number typed isn't a valid mobile number.                                                                                              | The employee checks the number and types it again.                                                                                                                                                                                                                                                                                |
| "Enter the last 6 digits or letters of your ID, passport or permit number."                           | Fewer than 6 characters of the ID, passport or permit number were typed.                                                                   | The employee types the full number, or at least its last 6 characters.                                                                                                                                                                                                                                                            |
| "We couldn't find these details. Check your mobile number and the last 6 of your ID, or speak to HR." | No employee record has this mobile number and this ID, passport or permit number together. The message is the same whichever one is wrong. | Compare both with the employee's record. Open the employee's **AllWage app** panel: if their mobile number was used with an ID that didn't match, the history shows "Sign-in attempt didn't match the ID on record". After 5 of these in a day, the app says "Too many tries" (see [#too-many-tries](#too-many-tries "mention")). |
| "Your employment isn't active. Speak to HR."                                                          | The details match an employee who has resigned, whose employment has ended, or who hasn't started yet.                                     | Check the employee's employment dates and status.                                                                                                                                                                                                                                                                                 |
| "AllWage isn't switched on for you yet. Ask HR to turn on Clock In/Out for you."                      | **Clock In/Out** is off for this employee.                                                                                                 | Turn on **Clock In/Out** for the employee (see [#switching-the-app-on-for-your-employees](#switching-the-app-on-for-your-employees "mention")).                                                                                                                                                                                   |
| "Your details are on more than one record. Speak to HR."                                              | More than one active employee record that may use the app has this mobile number and ID.                                                   | Make sure only one active record has these details. If you can't find the other record in your profile, contact [AllWage support](https://help.allwage.com/fundamentals/support-channels.md).                                                                                                                                     |
| "Your mobile number on record needs to be fixed. Speak to HR."                                        | The mobile number on the employee's record can't receive an SMS, so the sign-in code can't be sent.                                        | Correct the mobile number on the employee's record.                                                                                                                                                                                                                                                                               |
| "Your mobile number is already used by another employee's AllWage app. Speak to HR."                  | Another employee with the same mobile number on their record has already linked a phone.                                                   | Give each employee their own mobile number, or remove the other employee's phone if it's no longer theirs.                                                                                                                                                                                                                        |
| "Too many tries. Try again in 20 minutes, or speak to HR." (the time varies)                          | A limit on sign-in attempts was reached.                                                                                                   | See [#too-many-tries](#too-many-tries "mention").                                                                                                                                                                                                                                                                                 |
| "Update AllWage to sign in. Clocking keeps working on a linked phone."                                | The app version is too old to sign in.                                                                                                     | Update the AllWage app from where it was downloaded.                                                                                                                                                                                                                                                                              |
| "Couldn't reach AllWage. Check your connection and try again."                                        | The phone has no connection to AllWage.                                                                                                    | Connect to mobile data or Wi-Fi and try again.                                                                                                                                                                                                                                                                                    |

#### Too Many Tries

To protect employees' accounts, AllWage limits how often someone can try to sign in. When a limit is reached, the app says "Too many tries. Try again in …, or speak to HR." and shows how long to wait, for example **20 minutes** or **14 hours**.

The limits are:

* **5 attempts a day with details that don't match.** This is the one employees usually reach: they keep entering a wrong ID number, or the ID number on their record has a mistake. It counts per mobile number, so typing the number another way (for example **+27** instead of **0**) doesn't help.
* **20 attempts an hour, and 50 a day,** with the same mobile number or the same ID number.
* **3 sign-in codes an hour, and 6 a day,** for the same ID and mobile number. **Send again** counts as a new code.

Hourly limits reset on the hour. Daily limits reset at **02:00** South African time, so an employee who reaches the daily limit at 10:00 waits until 02:00 the next morning.

**Nobody can lift the limit early**, including AllWage support. While the employee waits:

1. Check the ID, passport or permit number and the mobile number on the employee's record, and correct any mistake. The employee's **AllWage app** panel shows each attempt that didn't match the ID on record.
2. Have the employee clock another way until the limit resets, for example with their manager or a fixed device.
3. Once the time has passed, the employee signs in once, carefully, with the details on their record.

{% hint style="info" %}
A wrong **sign-in code** has its own limit: after 5 wrong codes, the code stops working and the app says "Wrong code. This code has stopped working. Tap Send again for a new one."
{% endhint %}

## How Employees Clock

1. **Open the app.** It starts finding the location straight away: **Finding your location…**, then **Location ready**.
2. **Clock in:** tap **Clock In** and choose the activity. The activities the employee used recently are at the top, and they can search the full list.
3. **Clock out:** tap **Clock Out**. No activity is needed.
4. The app confirms the clock: **Recorded**, or **Waiting to send** if there's no signal.

To change activity during a shift, the employee taps **Switch activity** and chooses the new one. No clock-out is needed. Employees can clock in and out as many times a day as they need.

### When the Location Isn't Ready

A good GPS location is required for every clock. Until the phone has one, the clock buttons are unavailable and the app explains why:

* **Turn on location** or **Allow AllWage to use your location**: the phone's location is off, or the app hasn't been allowed to use it.
* **Turn on Precise location**: the phone only shares an approximate location, which is never accurate enough.
* **We can't find your location. Move outside, away from buildings**: indoors, phones often can't find an accurate location.

If the employee taps **Clock In** or **Clock Out** before the location is ready, **no clock is recorded** and the app says why:

* "Finding your location… Nothing was recorded.": the phone doesn't have a location yet.
* "Your location isn't accurate enough yet. Nothing was recorded.": the phone has a location, but it isn't accurate enough yet.
* "Your location is out of date. Wait a moment. Nothing was recorded.": the phone's last location is too old to use. A clock needs a location from the last 30 seconds.

In each case, the employee keeps the app open, waits for **Location ready**, and taps again. Moving outside, away from buildings, helps the phone find a fresh location faster.

{% hint style="warning" %}
The app may not be suited to employees who clock inside a building, where phones often can't find their location. Use a fixed device there, or have their manager clock them.
{% endhint %}

### Location and Privacy

The app reads the location **only while it is open**, and keeps one location per clock. It never tracks employees during the day and never reads their location in the background.

Your business is responsible for your employees' personal information, and AllWage processes it on your behalf. Employees see a short privacy notice before they first use the app.

## Managing Employees' Phones

Navigate to [**Manage > Employees**](https://app.allwage.com/#/system/employees/manage), click the **overflow icon** (the three dots on the right of the employee's row) and click **AllWage App**. The panel shows the employee's phone, its history and its recent syncs, and lets you take the actions below.

### New Phone

When an employee gets a new phone, they need a **setup code** from you:

1. Open the employee's **AllWage app** panel.
2. Click **Generate setup code** to give the code in person, or **Send by SMS**.
3. The employee signs in on the new phone and enters the setup code. It's valid for **15 minutes** and can be used once.

The old phone stops clocking. Clocks it captured before the change are still delivered if it connects within 7 days. The employee gets an SMS to say the app is now active on a new phone.

### Lost or Stolen Phone

Open the employee's **AllWage app** panel, click **Remove phone** and choose the reason. The phone stops clocking the next time it connects.

After a phone is reported lost or stolen, give the setup code for the new phone **in person only**, because whoever has the phone probably has the SIM card too.

### Employees Who Leave and Return

When an employee's employment ends, the app switches clocking off on their phone and tells them why. If you reactivate the same employee record later, for example for seasonal workers, clocking switches back on by itself. No setup code is needed.

### Changing an Employee's Mobile Number

Only change the mobile number on the employee's record. Their phone keeps working, and future codes go to the new number. The old number receives an SMS letting them know about the change.

## Before Payroll: Clocks Still on Phones

Because the app works without signal, some clocks may still be waiting on phones when you run payroll. To find them:

1. On the employee list, select the **AllWage app** column preset.
2. Filter **Sync health** to show anything except **OK**.
3. Follow up with these employees before you run payroll:
   * **Clocks waiting:** the phone has clocks it hasn't sent yet. Ask the employee to open the app with signal.
   * **Not seen 7+ days:** the phone hasn't connected for a week, so it may hold clocks we haven't received.
   * **Not accepted:** a clock couldn't be accepted. Capture it manually with the normal clock tools.

## Checking How a Clock Was Captured

To see how an app clock was captured, open the clock in the clock edit dialog. The **capture details** section shows its location and accuracy, where the clock time came from, the result of the GPS spoofing check and when the clock arrived. Use it to answer any dispute about a clock.

## Common Questions

#### The phone doesn't have enough space to install the app

The AllWage app needs very little space: about **6 MB** to download and about **20 MB** once installed. Freeing up a small amount of space is usually enough:

* **Delete old WhatsApp photos, videos and voice notes.** They're often the biggest use of space on a phone. In WhatsApp, go to **Settings > Storage and data > Manage storage**.
* **Uninstall apps the employee doesn't use.**
* **Clear the cache of large apps,** such as WhatsApp, Facebook or the browser. In the phone's **Settings > Apps**, choose the app, then **Storage > Clear cache**. This doesn't delete the employee's chats or photos.

Then try installing the AllWage app again.

**The employee never receives the SMS code.** Check that the mobile number on their record is correct and can receive an SMS. Dual-SIM users should check messages on both SIMs. The AllWage app panel's history shows whether the SMS was delivered.

**The app says "We couldn't find these details".** The mobile number and the ID, passport or permit number don't match any employee record together. Check both on the employee's record. The employee's **AllWage app** panel shows a sign-in attempt that didn't match their ID number for 30 days. For every sign-in message, see [#sign-in-messages](#sign-in-messages "mention").

**The app says "Too many tries".** The employee reached a sign-in limit, usually after 5 attempts in a day with details that don't match. They must wait for the time the app shows; nobody can lift it early. See [#too-many-tries](#too-many-tries "mention").

**The app says "AllWage isn't switched on for you yet".** Turn on **Clock In/Out** for the employee. See [#choosing-who-can-use-the-app](#choosing-who-can-use-the-app "mention").

**The app says "Your location is out of date" when the employee clocks.** Nothing was recorded. The employee waits for **Location ready** and taps again. See [#when-the-location-isnt-ready](#when-the-location-isnt-ready "mention").

**The app says "Clocking is switched off on this phone".** Clock In/Out was turned off for the employee, or their employment has ended. Their phone stays linked, and clocking comes back once it's switched on again.

**Can two employees share a phone?** No. Each employee needs their own phone and their own mobile number.

**What if an employee can't use the app?** For example, they have no smartphone, or they work indoors. Their manager clocks them, or they use a fixed biometric device.

**What if the employee deletes the app before their clocks are sent?** Those clocks are lost, so make sure employees know to wait for **All clocks sent** before removing the app. To link again, they need a setup code.

**How do I find an employee from a screenshot?** Every screen in the app has a small support line at the bottom with a **phone code** (starting with **P-**). Search for it on the employee list with the **AllWage app** preset selected.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.allwage.com/fundamentals/allwage-employee-self-service-app.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
