Base64URL invalid character: why decoding fails (and how to fix it)
TL;DR: Validate locally, fix the first real error, validate again (no upload).
Handle Base64URL invalid character: why decoding fails (and how to fix it) with a repeatable Base64URL workflow: normalize alphabet, fix padding, decode locally, and validate.
Base64URL quick map
| Rule | Base64 | Base64URL |
|---|---|---|
| Alphabet | +, / | -, _ |
| Padding | Often has = | Often omits = |
| Typical use | General binary transport | URLs, JWT segments |
Focus for this query
- Strip whitespace first and check for characters outside [A-Za-z0-9_-].
Safe decode workflow
- Remove whitespace/newlines.
- Normalize alphabet:
-→+,_→/. - Add padding so length % 4 == 0.
- Decode locally and validate output shape (JSON/text/binary).
Runtime snippet (generic)
function base64urlToBase64(input) {
const s = String(input || '').replace(/\s+/g, '').replace(/-/g, '+').replace(/_/g, '/');
return s + '='.repeat((4 - (s.length % 4)) % 4);
}
const b64 = base64urlToBase64(token);
const bytes = Uint8Array.from(atob(b64), (c) => c.charCodeAt(0));
const text = new TextDecoder().decode(bytes);
console.log(text);Frequent failures
- Invalid character from copy/paste noise or wrong alphabet.
- Missing padding when decoder expects canonical Base64.
- JSON parse after decode fails when payload is not JSON/text.
Privacy guardrail
Base64/Base64URL strings can still contain secrets. Decode locally, redact sensitive fields, and only then share snippets.
FAQ
Is anything uploaded to a server? No. All processing happens locally in your browser. Files are never uploaded.
What is the recommended workflow? Validate the input, fix the first real issue, validate again, then export/convert. This avoids compounding errors.
Related tools
Related guides
Privacy & Security
All processing happens locally in your browser. Files are never uploaded.
Quick fix checklist
- Reproduce the error on a minimal input.
- Check type/format and field mapping.
- Apply the smallest safe fix.
- Validate on production-like payload.
Related by intent
Useful follow-up pages selected from real search impressions and no-click opportunities.
No-click fix: go invalid character closing bracket after top level valueNo-click fix: csharp invalid json primitiveNo-click fix: jsonwebtoken invalid algorithmRelated fix: neighbor csharp csharp stj could not be converted system double id workflows webhooksRelated fix: neighbor go csharp stj could not be converted system string token runbooks data importRelated fix: neighbor php csharp stj could not be converted system int32 data checklists data importRelated fix: neighbor csharp csharp stj could not be converted system int32 user id runbooks webhooksRelated fix: neighbor csharp csharp stj could not be converted system string token workflows webhooks
Next pages to check
Closest crawled pages without impressions yet. Added to speed first-impression conversion.
neighbor csharp csharp newtonsoft error converting infinity system int32 user id workfloneighbor csharp csharp newtonsoft error converting null system datetime value workflows neighbor csharp csharp stj could not be converted system int32 items 0 id runbooks webhoneighbor csharp csharp stj could not be converted system int32 items 0 id workflows enteneighbor csharp csharp stj could not be converted system int32 user id checklists analytneighbor csharp csharp stj could not be converted system int32 user id runbooks webhooksneighbor csharp go json cannot unmarshal array into field user email type float64 workflneighbor csharp go json cannot unmarshal string into field payload items type string cheneighbor csharp go json cannot unmarshal string into field payload items type string cheneighbor csharp winner compare csharp csharp newtonsoft error converting infinity systemneighbor csharp winner compare csharp csharp newtonsoft error converting infinity systemneighbor csharp winner csharp csharp newtonsoft error converting infinity system int32 ineighbor go csharp stj could not be converted system string items 0 id workflows data imneighbor go go json cannot unmarshal array into field payload items type float64 troubleneighbor go go json cannot unmarshal array into field payload user type string checklistneighbor go go json cannot unmarshal array into field user createdat type time time checneighbor go go json cannot unmarshal array into field user id type string runbooks api gneighbor go go json cannot unmarshal array into field user id type string runbooks edge neighbor go go json cannot unmarshal array into field user id type string runbooks webhoneighbor go go json cannot unmarshal array into field user id type string workflows data
First Impression Acceleration
Pages prioritized for first search impressions with fresh crawl/indexing signals.
neighbor csharp go json cannot unmarshal string into fieldneighbor php go json cannot unmarshal string into field paneighbor csharp go json cannot unmarshal string into fieldneighbor php go json cannot unmarshal string into field usneighbor java go json cannot unmarshal string into field pneighbor php go json cannot unmarshal string into field toneighbor csharp go json cannot unmarshal string into fieldneighbor php go json cannot unmarshal string into field paneighbor node go json cannot unmarshal string into field pneighbor php go json cannot unmarshal string into field usneighbor csharp go json cannot unmarshal string into fieldneighbor php go json cannot unmarshal string into field usneighbor csharp winner compare csharp csharp newtonsoft erneighbor php go json cannot unmarshal string into field usneighbor java go json cannot unmarshal string into field pneighbor php go json cannot unmarshal object into field us