Troubleshooting Guide

This is the most common issue and usually occurs when you're not logged into Keka or your session has expired.

Solution Steps

1. Open a new tab and navigate to your company's Keka dashboard: https://yourcompany.keka.com/
2. Log in with your Keka credentials if not already logged in
3. Verify you can see your attendance dashboard and data
4. Return to the extension and click the "Retry" button
5. The extension should now successfully fetch your data

Other Possible Causes

• Session Expired: Try logging out of Keka completely and logging back in
• Incorrect Subdomain: Verify your company's subdomain in Settings matches your Keka URL
• Network Issues: Check your internet connection and ensure Keka's website is accessible
• Browser Issues: Clear browser cache and cookies, then try again

If the checkout time or hours don't match your expectations, verify your configuration settings.

Check These Settings

1. Open the Settings tab in the extension
2. Verify Total Working Hours matches your company policy (e.g., 8.5 hours)
3. Confirm Required Daily Effective % is correct (commonly 100%)
4. Ensure Required Monthly Average % is accurate (commonly 100%)
5. Check Partial Leave Minutes allowance matches your company's policy
6. Set Count Early Clock In to match whether your company counts time worked before your shift starts
7. Set Allow Clock In Flexibility and Clock In Flexibility Minutes to match your company's grace period

Verify Data Source

• Open your Keka dashboard and compare attendance logs
• Ensure check-in/out times match what's shown in the extension
• Check if break time is being calculated correctly

Issues with extension installation or browser compatibility.

For Firefox Users

• Ensure you installed the Firefox version from Firefox Add-ons
• Check that the extension is enabled in about:addons
• Try disabling and re-enabling the extension

For Chrome Users

• Ensure you installed the Chrome version from Chrome Web Store
• Navigate to chrome://extensions/ and verify it's enabled
• Check for any error messages in the developer mode

General Solutions

1. Try removing and reinstalling the extension
2. Clear your browser cache and cookies
3. Restart your browser completely
4. Check if you're running the latest browser version
5. Open browser console (F12) and check for error messages

Your settings don't persist after closing the extension.

Possible Causes

• Browser in Private/Incognito Mode: Extensions in private browsing may not save data persistently
• Browser Storage Cleared: Check if your browser is set to clear extension data on exit
• Invalid Configuration: Ensure all fields pass validation (no red borders)

Solution

1. Use a normal (non-private) browser window
2. Fill in all required fields in the Settings tab
3. Ensure no fields show error states (red borders)
4. Click the "Apply Configs" button
5. Wait for the extension to automatically switch to the Home tab
6. Close and reopen the extension to verify settings persisted

The partial leave shown in Stats tab doesn't reflect recent requests.

Explanation

The extension shows both pending and approved partial leave requests for the current month. This ensures accurate balance calculations even before requests are approved.

What to Check

• Check if the request was submitted for the current calendar month
• Click the "Retry" button to refresh data from Keka
• Verify the request is visible in your Keka dashboard under attendance requests
• Ensure you're viewing the correct month's data

The extension keeps trying to open background tabs but fails to get your authentication token.

Solutions

1. Log out of Keka completely and log back in with your credentials
2. Verify you can manually access your Keka dashboard without issues
3. Check if your browser is blocking pop-ups or background tabs
4. Disable other extensions temporarily to check for conflicts
5. Clear browser cookies specifically for keka.com
6. Try using the extension in a different browser profile

The circular gauge chart visualizes your work progress for the day.

Troubleshooting

• No Check-in Today: The gauge won't display if you haven't checked in yet
• Data Loading: Wait for attendance data to load completely (loading indicator should disappear)
• Configuration Missing: Ensure you've set up your total working hours in Settings

The About tab picks a dad joke from the extension's built-in joke list the first time you open it during a popup session.

What to Expect

• No internet connection or external joke service is required
• The joke is cached until the popup is closed, so reopening About in the same popup shows the same joke
• If the same joke keeps showing, close and reopen the popup to start a new session

Want a Fresh Joke?

1. Close the extension popup
2. Open it again
3. Go back to the About tab

The extension should automatically detect and enable the half-day toggle if you've applied for half-day leave today.

Why This Might Happen

• Leave Duration: Only leaves with exactly -0.5 duration are detected as half-day
• Date Mismatch: The leave must be for today's date
• Not in Leave History: The leave must appear in Keka's leave history for detection to work

Manual Override

You can always toggle the half-day option manually if the auto-detection doesn't work. The toggle will reduce your required working hours by 50%.

The positive variance feature lets you leave early by using overtime hours from previous days.

Why It's Disabled

• No Positive Variance: Your monthly average is not above the required hours, so there's no surplus to use
• Variance Exhausted: Your partial leave usage has consumed all available variance
• First Day of Month: Not enough data to calculate variance yet

How to Build Variance

Work more than your required hours consistently to build up a positive variance. The extension shows your current variance in the Stats tab under "Average Variance".

When your monthly variance is below zero, the extension shows Cover Negative Variance in place of Use Positive Variance.

What It Does

• Adds your current monthly shortfall to today's checkout calculation
• Caps the calculated checkout time at 11:59 PM on the same day
• Turns off Minimum Effective Hours when enabled, just like Use Positive Variance

Your first clock-in of the day is checked against your shift start time from Keka. If it is later than allowed, it is shown in orange with a warning icon. Hover over the icon to see how late you were.

How the Allowed Time Is Worked Out

• Flexibility off: any clock-in after your shift start is flagged
• Flexibility on: you can clock in up to your Clock In Flexibility Minutes after shift start without a warning
• Late arrival request: a late arrival request applied for today (pending or approved) adds its minutes to the allowed time

What to Do

1. If your company has a grace period, turn on Allow Clock In Flexibility in Settings and enter the minutes
2. If you applied a late arrival request, click "Retry" or reopen the extension to refresh your data

If you clocked in before your shift start, that early time may not be counted.

Why This Happens

• The Count Early Clock In setting is off by default
• When it is off, effective hours only start counting from your shift start, and your checkout time is counted from the shift start too
• This applies to today's calculations on the Home, Stats, and Plan tabs. The monthly average uses Keka's own figures for past days

Solution

1. Open the Settings tab
2. Turn on Count Early Clock In if your company counts time worked before your shift
3. Click "Apply Configs"

When an update adds new settings, the extension asks you to review them once so your calculations match your company's policy.

What to Expect

• A notice lists the new settings the first time you open the extension after the update
• Your existing settings are kept and filled in for you
• The other tabs stay locked until you click "Apply Configs"
• If you close the extension without applying, it opens on Settings again next time (without the notice)

The extension supports system, light, and dark themes.

Common Issues

• System Theme: If set to "System", the theme follows your browser/OS preference and may change automatically
• Cache Issue: Try closing and reopening the extension after changing the theme
• Configuration Not Applied: Make sure to click "Apply Configs" after changing the theme in Settings

Solution Steps

1. Go to the Settings tab
2. Select your preferred theme from the dropdown
3. Click "Apply Configs" button
4. Close and reopen the extension

The monthly average is calculated based on completed working days, excluding today and weekends.

Important Notes

• Today Excluded: Today's hours are NOT included in the average to avoid skewing results mid-day
• Weekends Excluded: Weekend hours don't count toward your monthly average as they aren't included in payroll calculations
• Only Working Days: Holidays and leave days are not counted in the denominator
• Full-Day Leaves Excluded: If you take a full day of leave, that day is left out of your average entirely, the same way Keka leaves it out of payroll. This also applies if you take a first-half and second-half leave separately on the same day, since together they add up to a full day off

How It's Calculated

Average = Total Effective Hours (past working days) / Working Days This Month

To verify, check your Keka dashboard's monthly stats and compare with the Stats tab in the extension.

After updating the extension, a red dot badge appears on the icon to notify you.

Solution

Simply click on the extension icon to open the popup. The badge will automatically clear once you open it.