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.

Illustration of an open iron-bound trunk full of ornate blank cards on plum velvet

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.

  1. 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.
  2. Open PersonaChat's Workshop tab. The Workshop manages every character you own, created and imported alike.
  3. Tap Import and select the character file.
  4. 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.
  5. Start the scene. Imported characters work everywhere built-ins do, including group chats.
Privacy note: the imported character card stays on your device, and importing it does not upload the card. Your durable chat history remains local, while selected chat content is processed by the AI providers used for replies and optional memory updates. More on the privacy model.

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.

Bring your collection home

Download PersonaChat free and give your character cards a native iOS home.

Download on the App Store

4.4 on the App Store · Free · iOS 17+