Goony.ai —

Character card PNG not importing? Causes and fixes

A card PNG that won't import has usually lost the hidden data that holds the character. How to check a PNG for chara or ccv3 data and get a working copy.

Updated Oct 26, 2026 · 8 min read

In this article
  1. Quick diagnosis
  2. How the character hides inside a PNG
  3. The usual causes
  4. How to check whether a PNG still has a card
  5. Fixes that actually work
  6. Or skip the file and import by link
  7. FAQ

A character card PNG won't import when the image no longer carries the card. The character lives in a hidden text chunk inside the PNG (chara for V2 cards, ccv3 for V3) holding base64-encoded JSON, and a screenshot, a conversion to JPG or WebP, or a re-save by an app that recompresses images throws it away. Download the original file from the card's page again, check it with one of the methods below, or skip files and import the card by link.

The face survives all of this, which is what makes it confusing: the picture looks identical, and the character inside is gone.

Quick diagnosis

What you see Most likely cause Fix
"No character data" or an error on import The file is a plain picture: a screenshot or a saved preview Download the card again from its page
A character appears with an empty description The data was stripped, or the importer only found an image Re-download; try the JSON version
The importer rejects the file type It's a WebP or JPG renamed to .png Find the real PNG (or see SillyTavern's tip below)
Works in one app, not in another Format version: a V3-only card, a CHARX file, or an app that expects V2 Export a V2 PNG or JSON from an app that reads V3
"Invalid JSON" or a parse error The data was edited by hand or cut short Re-download, or fix the JSON
The site refuses the card after reading it Its content rules, or a private definition Check the site's policy; ask the creator
You have a link but no file Nothing wrong at all Import by link where the app supports it

How the character hides inside a PNG

A PNG file is a stack of chunks: the image data, plus optional text chunks with a keyword and a value. Character cards use that space. SillyTavern's card parser looks for a text chunk named ccv3 first, then chara, and base64-decodes whichever it finds into the card's JSON. When it writes a PNG, it removes the old card chunks and writes both: chara with the card as stored, and ccv3 with the same data labeled as a V3 card.

The V3 spec makes the ccv3 name a requirement, encodes the JSON as UTF-8 then base64, lets apps fall back to a chara chunk, and says an app that finds both should use ccv3.

None of this is part of the picture itself. Any tool that rebuilds the image from its pixels, rather than copying the file, writes a new PNG (or a JPG, or a WebP) without those chunks. That's the whole problem in one sentence.

The usual causes

1. It's a screenshot or a saved preview

A screenshot is a brand-new image of your screen: it has never contained the card. Saving a thumbnail from a list page or a gallery does the same thing more quietly, because sites often serve resized copies, sometimes in WebP, for previews. Always use the site's own download option. On Chub, the Download button on a character's page offers PNG or JSON.

2. It was converted or re-saved

Opening the card in an image editor and saving it again, running it through an "optimizer", cropping it in your phone's photo app, or converting it to JPG or WebP all rebuild the image and drop the text chunks. SillyTavern's FAQ puts it plainly: "Some programs or file managers will strip the embedded definitions from the card when you save them." Converting a JPG back to PNG doesn't bring anything back; once the chunk is gone, it's gone.

3. A site or app recompressed it

Social networks and many chat apps re-encode the images you post, and image hosts often do the same. If someone shared a card as an image in a feed, assume the data didn't survive. In chat apps, download the attachment itself rather than saving the preview shown in the conversation. The safest way to share a card is the JSON file, a zip, or simply the link to its page.

4. It isn't really a PNG

A file named .png can be something else: a WebP that was renamed, or even an error page saved when a download failed (that one is usually tiny, a few kilobytes). SillyTavern's FAQ lists the renamed-WebP case and suggests renaming the file to .webp before importing it, or finding a true PNG version.

5. The format version doesn't match

Cards have evolved. V2 lives in a chara chunk; V3 lives in ccv3, and CHARX is a zip file with a card.json inside. An older tool that only reads chara won't see a card that carries only ccv3, and a PNG-only importer won't open a CHARX file. RisuAI reads V2 and V3 and can export a V2 PNG, a V3 PNG, CHARX or JSON (source), which makes it a handy converter.

6. The data is broken

If someone edited the JSON by hand, one stray comma makes it unreadable. A download that stopped halfway leaves the end of the base64 missing. Both show up as parse errors rather than "no data".

7. The importer read it and said no

Sites apply their own rules after reading a card. Goony, for one, checks every imported card against its content policy and refuses those that break it, anything involving minors for a start. And on sites where a creator's full definition sits behind a login, such as JanitorAI, an importer may only get the public part.

How to check whether a PNG still has a card

The text-editor check

Open the PNG in a plain text editor (or any viewer that shows raw bytes) and search for chara and ccv3. Text chunks aren't compressed, so the keyword is readable among the binary noise. Right after it you should see a long run of letters and digits, usually starting with eyJ, which is how a JSON object beginning with {" looks in base64. No keyword, no card.

The script check

If you have Python installed, this short script reads the chunks and prints the card's spec and name. It uses only the standard library and changes nothing.

import sys, struct, base64, json

data = open(sys.argv[1], 'rb').read()
if data[:8] != b'\x89PNG\r\n\x1a\n':
    sys.exit('Not a real PNG (a renamed WebP or JPG, or an error page)')
pos, found = 8, False
while pos < len(data):
    length, kind = struct.unpack('>I4s', data[pos:pos + 8])
    body = data[pos + 8:pos + 8 + length]
    if kind == b'tEXt':
        key, _, value = body.partition(b'\x00')
        if key.lower() in (b'chara', b'ccv3'):
            card = json.loads(base64.b64decode(value))
            print(key.decode(), card.get('spec', 'v1'), card.get('data', card).get('name'))
            found = True
    pos += 12 + length
if not found:
    print('No card data in this file')

Save it as checkcard.py and run python3 checkcard.py yourcard.png. A healthy V2 card prints something like chara chara_card_v2 Name; a file exported by SillyTavern prints two lines, one per chunk. "No card data" means the file is only a picture. A crash on the JSON line means the data is there but damaged.

The app check

Import the file into an app that reads cards, then open the character and read its description. Empty fields mean empty data. If you use SillyTavern or RisuAI already, this is the fastest test.

Fixes that actually work

  1. Download it again from the source. Go back to the card's page and use the site's download option, not a right-click on the image. If you can't remember where it came from, search the character's name on Chub; you may also find a newer version.
  2. Take the JSON instead. Where a site offers JSON, take it. It holds the same definition with no image to damage, and every major card app reads it. Keep the PNG for the portrait.
  3. Ask the creator for the original file, sent as a file or a zip, not pasted as an image.
  4. Re-export from an app that can read it. If one app reads the card and another doesn't, export a fresh V2 PNG or JSON from the one that works.
  5. Rebuild it. If the data is truly gone and you remember the character, the fields are short enough to retype: name, description, personality, scenario, first message, a few example lines.

Most of these problems belong to files. A link-based importer fetches the card from the site that hosts it, so there's no image to recompress and no chunk to lose. SillyTavern can import by link from six card sites. Goony works only this way: paste a chub.ai, JanitorAI, AICharacterCards.com, Perchance, RisuRealm or TelegAI link or ID into Import a character, and it reads the card (Tavern/SillyTavern V2 and V3, Risu and Perchance formats) on its server. It has no PNG or JSON upload, so a card you only have as a file needs its page link instead. The full walk-through is in our guide to importing a character card, and Chub cards are one click away in the community catalogue.

Imports on Goony default to Local: characters you create or import locally, and your Offline chats, live in your browser, not in Goony's database. Each reply is still generated on Goony's servers. If you're comparing where your cards work best, our Janitor AI vs Chub AI and SillyTavern alternatives pieces cover the main options.

FAQ

Why does my card import as a blank character?

The importer found an image but no card data inside it, or only part of it. Download the card again from its page, preferably as JSON, and check the new file for a chara or ccv3 text chunk.

Can I convert a WebP or JPG card back to PNG?

You can convert the image, but the character won't come back. The card data lived in a PNG text chunk that the conversion threw away, so you need the original file or the card's page.

What's the difference between the chara and ccv3 chunks?

The chara chunk holds a V2 card and the ccv3 chunk holds a V3 card, both as base64-encoded JSON. The V3 spec says apps that find both should use ccv3, and SillyTavern writes both when it exports a PNG.

Is a JSON card safer than a PNG card?

For keeping the definition intact, yes. A JSON file can't lose its data to image compression, though it carries no portrait. Keeping both is the safest habit.

Can Goony read my PNG card file?

No. Goony imports cards by link or ID from six card sites and has no file upload. Find the card's page on one of those sites and paste the link, or rebuild the character in the creator.

Why does a card work in SillyTavern but not in another app?

Usually a version mismatch: the card may be V3-only or a CHARX file, and the other app may read only V2 PNGs. Export a V2 PNG or a JSON copy from SillyTavern and import that instead.

Characters to try

Try Goony.ai

Chat with any character for free — 20 messages a day, no card needed. Create your own or import one from the community.

Keep reading