How to Import Character Cards on iPhone
You've collected characters you love, from creator communities, friends, or your own past projects. Here's how to bring them onto your iPhone and give them a native home in PersonaChat.
What character cards are
A character card is a portable definition of an AI character: name, personality, backstory, scenario, and example dialogue bundled into a shareable file. Communities across the AI roleplay world trade thousands of them, which means the character you want may already exist, written by someone who obsessed over getting the voice right.
The catch: most tools for using them are desktop-first web apps. If you want those characters in your pocket, in a native iOS interface, with your chats stored privately, that's what importing into PersonaChat is for.
Importing into PersonaChat
Coming from Chub specifically? There's a dedicated walkthrough for importing Chub AI characters; the steps below cover cards from any source. Coming from Character AI? Its data export isn't a character card and won't import, so save your characters this way instead.
- Get the character's JSON file onto your iPhone. PersonaChat reads cards saved as JSON, not PNG card images, so pick the JSON download. Download it in Safari (it lands in Files → Downloads), save it from a chat app, or AirDrop it from your Mac.
- Open PersonaChat's Workshop tab. The Workshop manages every character you own, created and imported alike.
- Tap Import and select the character file.
- Review the character. The card's description, greetings, and example dialogue come in as editable fields, so you can sharpen or rewrite anything before the first chat. If the card has separate personality or scenario fields, copy those in by hand; the import skips them.
- Start the scene. Imported characters work everywhere built-ins do, including group chats.
After the import
Treat the card as a first draft. Cards written for other platforms sometimes lean on formatting quirks of those platforms. If a character feels slightly off, open them in the Workshop and tighten the personality or example dialogue; the same rules as creating from scratch apply.
Give them a scene worth entering. A great character with a flat opening scenario still stalls. Rewrite the scenario field so the first message hands you a role and a choice.
Mix them into an ensemble. Imported characters next to your own creations in a group scene is where a collection becomes a cast.
Quick answers
Can I import characters into PersonaChat?
Yes. The Character Workshop has an Import option that brings in character cards saved as JSON files, and imported characters work like any built-in character.
Are imported characters uploaded to a server?
The card is saved on your device; there's no PersonaChat character library on a server. During import, some of its text (the description and opening messages) is sent to the AI service so it can write short summaries, and chats with the character go to the AI provider like any other chat.
Can I edit a character after importing it?
Yes. Imported characters open in the Workshop as editable fields, so you can adjust the personality, scenario and story starters at any time.