"Invalid PIN or Password" — Cannot Log In to iTax
This is the most common iTax error, and it usually has a simple fix. The iTax login system is strict about formatting and case sensitivity. Before you panic, run through these checks.
Caps Lock is on
iTax passwords are case-sensitive. If Caps Lock is on, your password will not match. Type your password into a text editor first to see exactly what you are sending, then paste it into iTax.
Wrong KRA PIN format
Your KRA PIN must be in the exact format: A0123456789Z. All uppercase, no spaces, no hyphens, exactly 11 characters. If you are entering a lower-case letter or adding a space, iTax will reject it.
Password has expired or been reset
KRA requires password changes every 90 days. If you have not logged in recently, your password may have expired. Click 'Forgot Password' to reset it.
Browser saved an old password
Many users have multiple KRA PINS or old passwords saved in their browser. Clear your saved passwords for itax.kra.go.ke and type your credentials manually.
If none of these work, your account may be locked (see the KRA PIN Locked section below) or you may need to visit a KRA Huduma Centre with your original ID and KRA PIN certificate to have your credentials reset in person.
"System Timeout" or "Session Expired" — iTax Keeps Logging You Out
iTax sessions time out aggressively after just 15-20 minutes of inactivity. But many users report being logged out even while actively filling forms. Here is why this happens and how to fix it.
Clear your browser cache and cookies
Go to your browser settings and clear all cached data for itax.kra.go.ke. Stale session cookies are the number one cause of premature timeouts. Restart your browser completely after clearing.
Use Chrome or Edge (version 120+)
iTax is optimised for Chromium-based browsers. Google Chrome and Microsoft Edge versions 120 and above work best. Firefox users report more frequent session timeouts and display issues. Safari on Mac also works but can be slower.
Switch to a faster internet connection
If you are on 3G, switch to 4G or Wi-Fi. Unstable connections cause iTax to lose its session. A minimum of 2 Mbps is recommended for reliable iTax access.
Log in during off-peak hours
The iTax servers are most congested between 8 AM and 6 PM on weekdays, and especially on the 15th-20th of each month. Try logging in early (before 8 AM) or late (after 10 PM) for a much smoother experience.
Disable browser extensions
Ad blockers, VPN extensions, and privacy tools can interfere with iTax session management. Disable all extensions temporarily or use an incognito/private browsing window.
Losing data when timed out?
iTax does not auto-save your form data. If your session times out or the portal crashes while you are filling a return, all the information you entered is lost. Always prepare your VAT return data in a spreadsheet first, then copy it into iTax in one go. This is also why many businesses prefer to have a VAT agent file for them.
"Page Not Loading" or "Error 500" — iTax Server Down
An Error 500 page or a completely blank screen usually means the iTax server is overwhelmed or undergoing maintenance. This is not something you can fix on your end. KRA's iTax infrastructure has struggled with capacity for years.
Check if iTax is down for everyone
Visit downdetector.co.ke or check X (Twitter) for mentions of 'iTax down' or 'KRA portal'. If other users are reporting the same issue, it is a KRA-side outage and you just need to wait.
Wait 30-60 minutes and try again
Most iTax outages resolve within an hour. KRA typically restarts the servers or clears the backlog during this window. Do not keep refreshing every 30 seconds — this can get your IP temporarily blocked.
Try after 10 PM or before 6 AM
KRA performs scheduled maintenance during off-peak hours, typically between midnight and 6 AM. If the portal is down during the day, try again late at night when fewer users are online.
Contact KRA if the outage lasts more than 4 hours
If the portal has been down for more than 4 hours during a business day, call KRA Contact Centre on 020 499 9999 or 0711 000 471. Ask for an update and request that they note the outage in case you miss a deadline.
Pro tip: Always take a screenshot when you encounter an Error 500 or a blank page, especially if it is close to the 20th deadline. You can use this screenshot as evidence if KRA later tries to impose a late filing penalty. Save it with the date and time visible.
"OTP Not Received" — SMS One-Time Password Delays
iTax sends a One-Time Password (OTP) via SMS every time you log in. During peak periods, these SMS messages can take 10-30 minutes to arrive — or may not arrive at all. Here is what to do.
Wait at least 5 minutes before re-sending
Each time you click 'Resend OTP', the previous code is invalidated. Clicking multiple times in quick succession only makes the situation worse. Wait at least 5 minutes.
Check your spam and blocked messages
Some mobile networks flag KRA SMS as spam. Check your spam folder or blocked messages list. Try saving the KRA sender number to your contacts to prevent future filtering.
Try the email OTP option
iTax also sends the OTP to your registered email address. If the SMS is delayed, check your email inbox (and spam folder) for the OTP. The email usually arrives faster than SMS during peak times.
Update your phone number at a KRA Huduma Centre
If you have changed your phone number, the OTP is being sent to your old number. You must update your contact details in person at a KRA Huduma Centre. Bring your ID and KRA PIN certificate.
If you cannot receive OTPs on either SMS or email, and you need to file a return urgently, contact Smart VAT Kenya on WhatsApp. As KRA-registered agents, we can file VAT returns on your behalf using our agent portal — no OTP required.
"Forgot Password" Not Working or Reset Link Not Arriving
The iTax password reset process relies on your registered email address. If that email is outdated or you cannot access it, you can get stuck in a loop. Here is how to break out.
Check your email spam folder for the reset link
The iTax password reset email often lands in spam or promotions folders. Search your email for 'KRA' or 'iTax' before assuming it did not arrive. The email comes from noreply@kra.go.ke.
Wait 10-15 minutes between reset attempts
iTax throttles password reset requests. If you click 'Forgot Password' multiple times in a row, the system may lock you out of the reset feature for up to an hour. Wait patiently.
You no longer have access to your registered email
This is the most common password reset blocker. If you cannot access the email address you registered with KRA, the online reset process will not work. You must visit a KRA Huduma Centre in person with your ID to update your email address.
Visit KRA Huduma Centre as a last resort
Visit any KRA Huduma Centre with your original ID and a copy of your KRA PIN certificate. Request a password reset at the counter. KRA will issue you a temporary password that you can change on first login.
Pro tip: KRA Huduma Centres have long queues, especially at month-end. Arrive before 8 AM to secure a spot. Alternatively, let Smart VAT Kenya handle your filing so you never need to log in to iTax again.
"Return Validation Failed" — iTax Rejects Your VAT Return
One of the most frustrating iTax errors happens when you have filled in all your figures, click submit, and iTax says "Return Validation Failed" without clearly explaining what is wrong. Here is what usually triggers this error.
Decimal format error
iTax expects decimal places to use a dot (.) not a comma (,). Entering '1,500.50' instead of '1500.50' can trigger validation failure. Do not include thousand separators at all — type '1500.50' exactly.
Missing required fields
Some fields in the VAT return form are mandatory even if the value is zero. Common missed fields include: 'Value of Exports', 'Input VAT at Standard Rate', and 'Output VAT at Standard Rate'. Make sure every field has a value entered.
Excel upload format mismatch
If you are using the Excel upload feature, your spreadsheet must match KRA's exact column template — same headers, same order, no extra columns. Download a fresh template from iTax each month and paste your data into it.
PIN does not match the registered business name
If you recently changed your business name or registered a new KRA PIN, iTax may reject the return because the PIN in the form does not match the name on record.
Return validation errors are the number one reason business owners give up and call us. At Smart VAT Kenya, we file hundreds of VAT returns every month. We know exactly how KRA's validation engine works and we never submit a return that will fail validation. Let us handle it for KES 3,500/month.
"Already Submitted" Error — Did iTax Already Receive Your Return?
You fill in the return, click submit, get an error, click submit again, and now iTax says "Already Submitted". This confusing error usually means the first submission actually went through — but you did not get a confirmation.
Check your return history before re-submitting
Go to 'Returns' then 'File VAT Return' and look at the status for the period in question. If it shows 'Filed' or 'Pending', your return was received. Do not submit again — filing a duplicate can trigger a penalty.
Look for the submission receipt in your email
iTax sends a confirmation receipt to your registered email after every successful submission. If you have the receipt, your return is filed. If not, the submission may have failed.
Wait 24 hours and check again
Sometimes iTax takes up to 24 hours to update the return status. If the period still shows 'Draft' or 'Not Filed' after 24 hours, your submission failed and you need to try again.
The safest way to avoid this confusion is to have your return filed by a KRA-registered agent. We get an instant system confirmation for every submission and can verify within minutes that your return has been accepted.
"Browser Compatibility" Warning — iTax Looks Broken
iTax displays a warning message about browser compatibility when it detects you are not using a supported browser. While the page may still load, key features like dropdown menus, date pickers, and submit buttons often malfunction.
Use Google Chrome 120+ or Microsoft Edge 120+
These are the only browsers officially supported by KRA for iTax. Both are based on Chromium and handle iTax's legacy interface correctly.
Firefox has known issues
Mozilla Firefox users frequently report that iTax dropdown menus do not open, date fields do not work, and the submit button appears greyed out. Switch to Chrome or Edge if you are on Firefox.
Safari works but is slower
Safari on macOS generally works with iTax but pages load slower and session timeouts are more frequent. Use Chrome on Mac for the best experience.
Do not use Internet Explorer
KRA's legacy 'Internet Explorer recommended' message is outdated. Do not use IE or the embedded iTax app email links that try to force IE. Use a modern Chromium browser.
eTIMS / iTax Login Confusion — Wrong Portal, Wrong Password
A growing source of login frustration: eTIMS (Electronic Tax Invoice Management System) and iTax are two separate systems with different URLs, different logins, and different passwords. Many business owners confuse the two.
iTax is at itax.kra.go.ke
This is where you file VAT returns, check penalties, apply for waivers, and manage your tax account. You log in with your KRA PIN and password.
eTIMS is at etims.kra.go.ke
This is where you generate tax invoices (e-invoices), manage inventory, and transmit sales data to KRA in real time. You log in with your KRA PIN but the password is typically different from your iTax password.
Different passwords, even if you set them the same
Even if you use the same password on both platforms, KRA treats them as separate accounts. Changing your password on iTax does not change it on eTIMS, and vice versa. If you reset one, the other does not change.
Quick check: which portal are you on?
Look at the URL in your browser address bar. If it says itax.kra.go.ke, you are on iTax. If it says etims.kra.go.ke, you are on eTIMS. The two portals also look different — iTax has a blue and white interface, while eTIMS has a green theme. If the page looks unfamiliar, check the URL first.
KRA PIN Locked — Too Many Failed Login Attempts
After 5 failed login attempts, iTax automatically locks your KRA PIN for security purposes. You will see a message saying your account has been temporarily disabled. This lock usually lasts 30-60 minutes, but in some cases it can last 24 hours.
Wait for the automatic unlock
The lock is usually temporary. Wait at least one hour before attempting to log in again. Do not keep trying — each failed attempt during the lock period extends the lock time.
Reset your password while locked
Even if your PIN is locked, you can still use the 'Forgot Password' feature. The lock applies to login attempts, not to password resets. Reset your password first, then try logging in.
Call KRA support to unlock your PIN
If the lock persists beyond 24 hours, call KRA Contact Centre on 020 499 9999 or 0711 000 471. You will need to verify your identity using your KRA PIN and ID number. They can unlock your account remotely.
Visit a KRA Huduma Centre for severe cases
If your PIN has been locked due to suspected fraudulent activity, you may need to visit a KRA Huduma Centre in person. Bring your original ID and KRA PIN certificate for identity verification.
If you frequently get locked out of iTax, consider using a KRA-registered agent like Smart VAT Kenya to file your returns. We access iTax through the dedicated agent portal and never experience these login issues.
Prevention: Never Deal with iTax Errors Again
The honest truth? The iTax portal is not going to get better. KRA has acknowledged the capacity issues, but improvements have been slow. Every month, thousands of Kenyan business owners lose hours of productive time battling the same iTax errors.
There is a simple alternative: never log in to iTax again. When you sign up for Smart VAT Kenya's auto-filing service, we handle everything through the KRA agent portal — a separate system designed for professional use that has much better uptime and reliability.
Here is what you get for KES 3,500/month:
- Monthly VAT return filed on iTax before the 20th deadline — every single month, guaranteed.
- No more login errors, no more OTP delays, no more browser compatibility warnings.
- We prepare your return from your sales and purchase records — you just send us the figures on WhatsApp.
- Penalty monitoring — we alert you if KRA has applied any penalties to your account.
- Free eTIMS support — we help you with invoice generation and eTIMS troubleshooting.
- Dedicated WhatsApp line — reach us anytime, not when iTax decides to work.
No setup fee. No long-term contract. You can cancel anytime. Just send us your sales and purchase figures each month via WhatsApp, and we take care of the rest. You will never see an iTax error screen again.
Tired of iTax Headaches?
Stop wasting hours every month fighting the iTax portal. Our KRA-registered agents handle your VAT filing from start to finish. No login errors, no timeouts, no stress — just KES 3,500/month and your returns are filed on time, every time.
Start Auto-Filing — KES 3,500/monthFrequently Asked Questions
- Why is the KRA iTax portal not working today?
- The iTax portal frequently experiences downtime due to server overload, especially around the 20th monthly deadline when millions of taxpayers log in simultaneously. Scheduled maintenance on weekends and unexpected system upgrades also cause outages. If the portal is down, wait 30-60 minutes and try again during off-peak hours (early morning or after 10 PM).
- How do I fix 'Invalid PIN or Password' on iTax?
- Check that Caps Lock is off — iTax passwords are case-sensitive. Ensure you are entering your KRA PIN in the correct format (e.g., A0123456789Z, all uppercase, no spaces). If you have forgotten your password, click 'Forgot Password' to receive a reset link via your registered email. If you cannot access that email, visit a KRA Huduma Centre in person with your ID.
- What should I do if iTax says 'System Timeout'?
- Clear your browser cache and cookies, then restart your browser. Use Google Chrome or Microsoft Edge (version 120 or newer) — Firefox sometimes has compatibility issues. Switch from 3G to 4G or Wi-Fi if you are on mobile data, or try a different internet connection. Finally, try logging in during off-peak hours (before 8 AM or after 10 PM) when the iTax servers are less congested.
- Why am I not receiving the iTax OTP?
- SMS delays are common during peak periods. Wait at least 5 minutes and check your spam or blocked messages. If the SMS still does not arrive, try the email OTP option instead — the one-time password is sent to your registered email address. If neither works, your phone number or email may need updating. Visit a KRA Huduma Centre to update your contact details, or log in to iTax and update your profile if you can access your account through the agent portal.
- Is eTIMS the same thing as iTax?
- No. eTIMS (Electronic Tax Invoice Management System) and iTax are separate KRA systems with different logins and different passwords. eTIMS is for generating and managing tax invoices and sending sales data to KRA in real time. iTax is for filing returns, checking penalties, and managing your overall tax account. Make sure you are on the correct portal and using the correct password for each system.
- What happens if I cannot file my VAT return because iTax is down on the 20th?
- If the iTax portal is down on the deadline, take a screenshot of the error or downtime message as evidence. File as soon as the portal is back up. If KRA later imposes a late filing penalty, you can apply for a penalty waiver citing system downtime. However, KRA does not automatically excuse late filings due to portal issues — you must proactively apply for the waiver. To avoid this stress entirely, consider using a KRA-registered VAT agent like Smart VAT Kenya who can file on your behalf without you ever needing to log in to iTax.