Fix Character Card PNG Not Importing in AI Chat
If you've downloaded a character card from Chub.ai or a Discord server and are wondering, "why won't my character card import?", you are not alone. Both SillyTavern and Tavern Studio rely on character card embedded metadata to load characters, and several common issues can break this process.
Here are the most common reasons a character card PNG is not loading and how to fix them.
1. The Metadata Was Stripped
Character cards are essentially standard image files (usually PNG) that contain hidden text data (JSON) inside a specific section called the tEXt chunk.
The Problem: Many image hosting sites, social media platforms (like Discord or Reddit), and even some mobile file managers automatically compress images to save space. In doing so, they strip out the embedded metadata, turning your character card into just a normal picture.
The Fix: Always download the original file directly from the source (like a direct download link on Chub.ai). If someone sent it to you over a messaging app, ask them to send it as a "File" or "Document" rather than an "Image" to prevent compression.
2. It's Actually a WebP File
The Problem: Sometimes you download a file that ends in .png, but your browser actually saved it as a WebP image. The internal structure is different, and the chat app cannot read the metadata.
The Fix: If your character card webp won't import, try renaming the file extension from .png to .webp. Tavern Studio natively supports importing metadata from both true PNG and true WebP files, provided the extension matches the file's internal format.
3. V2 vs V3 Format Incompatibility
The Problem: Character card standards have evolved. V1 was very basic, V2 added advanced fields (like alternate greetings and creator notes), and V3 introduced multi-character support and complex world structures. If you are using an older chat client, it might not understand a V3 card.
The Fix: Ensure you are using a modern AI chat client. Tavern Studio fully supports V2 and V3 character cards, automatically handling the parsing so you don't have to worry about format version mismatches.
By understanding how character card embedded metadata works, you can easily troubleshoot import errors and get back to roleplaying.