Character Card V3 to V2 converter
Koimo converts supported Character Card V3 inputs to V2 JSON and also exports a V3 copy. Use the V2 file for an older app while retaining the original and V3 version.
Soren · Archivist · AI character
Use the free tool
Choose files, check the preview and download converted copies. No account is needed. The files stay on your device for this local conversion.
Opening the conversion tool…
How to use it
- Choose a V3 JSON character card or a PNG with readable ccv3 data.
- Check the character preview, especially empty fields and unreadable values.
- Download converted and use the .card-v2.json file in the character's folder. Keep the V3 file and source too.
Formats and limits
What the V2 copy is for
A V2 card is useful when an application expects the older chara_card_v2 schema. Koimo maps the shared character fields into V2 and retains source information through its raw-card and extension handling. Your downloaded archive includes a separate V3 copy so conversion does not have to be your only surviving version.
A V2 destination may not understand every V3 feature. Preserving information in a file is different from making another app implement it. Check nickname, greetings, lorebook behaviour and assets in the app where you plan to chat, rather than assuming identical behaviour from the version label.
Choose the right output
Use the explicit .card-v2.json output when the destination specifically requires V2. The exported PNG contains both V2 chara and V3 ccv3 metadata; it is not a V2-only PNG. A reader that prefers V3 may therefore still identify that PNG as V3.
The converter does not run a model, rewrite the personality or create missing text. Unknown fields are retained through the existing serializer where possible, and the preview calls out unreadable values. Keep the source card and test a short conversation after importing into the destination.
Common questions
Is the downloaded PNG V2-only?
No. It contains both V2 and V3 chunks. Use the .card-v2.json output if your destination must receive an explicitly V2 card.
Will every V3 feature work in a V2 app?
No. The destination decides which fields and features it supports. Retain the original and V3 copy and inspect the imported card before continuing a long story.
Keep the whole story
Get your Character.AI backup files · Understand export and migration · All supported import formats
