← Back to Home

Troubleshooting Guide

Solutions to common issues with Keka Checkout Checker

❌ "Error in fetching attendance data"

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

Most Common Cause: You are not logged into your Keka dashboard in the same browser.

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

Pro Tip: Keep a Keka tab open in your browser while using the extension to maintain an active session.

🔢 Calculations seem incorrect

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

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

Note: The extension uses your browser's local time zone for all calculations. Ensure your system time is set correctly.

⚠️ Extension doesn't load or shows errors

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

💾 Configuration not saving or resetting

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

🏖️ Partial leave usage not updating

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

🔑 Token retrieval repeatedly fails

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

Technical Note: The extension retrieves your token by opening a temporary background tab to your Keka subdomain. If this fails repeatedly, there may be a browser security setting or extension conflict preventing it.

📊 Gauge chart not showing or stuck at 0%

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

Easter Egg: The gauge chart is also interactive! Click it 6 times to unlock a hidden About tab with additional information.

🌗 Half-day toggle not automatically checked

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%.

📈 "Use Positive Variance" toggle is disabled

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

Hover Explanation: Hover over the disabled toggle to see a tooltip explaining why it's unavailable.

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".

🎨 Theme not saving or switching properly

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

📊 Monthly average calculation doesn't match expectations

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

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.

🔴 Red dot on extension icon won't go away

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.

New Feature: The update notification feature was added in v3.0.1 to keep you informed of new features and improvements.

❓ Still Having Issues?

If none of the above solutions work, you can reach out for help:

Before Contacting Support:

  • Open your browser's developer console (press F12)
  • Look for any error messages (usually shown in red)
  • Take a screenshot of the error if possible
  • Note your browser version and operating system

Contact Developer:

Dharmit Lakhani - Independent Developer

Note: As this is a hobby project, response times may vary. Please provide detailed information about your issue for faster resolution.