Base64 Help & Guide

What is Base64?

Base64 is an encoding scheme that converts binary data into ASCII text format. It's used when you need to safely transmit binary data over channels that only support text (like JSON, XML, or email).

How It Works

Base64 takes 3 bytes (24 bits) and splits them into 4 groups of 6 bits. Each 6-bit group maps to a character from a 64-character alphabet (A-Z, a-z, 0-9, +, /).

When to Use Base64

• Data URLs: Embed small images directly in HTML/CSS
• API payloads: Send binary data through JSON APIs
• Email attachments: Classical MIME email uses Base64
• Configuration: Encode binary secrets in config files

URL-Safe Base64

Standard Base64 uses + and / which are problematic in URLs. URL-safe Base64 replaces these with - and _ and removes padding (=).

Issue: "Invalid character" Error

Cause: The input contains characters not valid for Base64.

Fix: Make sure your input is valid Base64. Common mistakes:

• Using padding incorrectly (= only at the end)
• Including whitespace or newlines
• Mixed standard and URL-safe Base64

Issue: String vs Binary

Cause: Confusion between encoding a string vs encoding actual binary data.

Fix: When encoding strings with non-ASCII characters (like 中文), UTF-8 encode first, then Base64 encode.

Issue: Increased Size

Cause: Base64 increases size by ~33% (3 bytes become 4 characters).

Fix: For large binary data, consider using binary transfer (multipart/form-data) instead.

Data URL Pattern

Embed small images in HTML:

<img src="data:image/png;base64,iVBORw0KGgo...">

Batch Operations

For multiple files, consider encoding each and storing in a JSON manifest:

{
  "files": [
    {"name": "icon.png", "data": "iVBORw0KGgo..."},
    {"name": "logo.svg", "data": "PHN2ZyB4bWxucz..."}
  ]
}

Performance Considerations

• Base64 encoding is fast but decoding can be slower
• Don't Base64-encode large files for performance-critical paths
• Cache encoded data when possible