Guide
Import SillyTavern character cards into Soliloquy
Soliloquy reads SillyTavern V1 and V2 character cards as a PNG with embedded card data or as a JSON file. Importing fills in the character editor for you to review. Selecting a file does not create or publish a character. You can review the fields before choosing Save draft or Create.
Names, personas, scenarios, greetings and example dialogue can carry over. World info, system prompts and some other fields do not. Long text is shortened, and tags that do not match Soliloquy's category list are left out.
What you can import
PNG character cards must contain the card data inside the image. An ordinary portrait image is not a character card. Soliloquy uses the PNG image as the avatar candidate and opens it for cropping.
JSON character cards can use the V2 format or the older V1 layout with fields at the top level. If the main greeting contains a Markdown image, its first accepted image URL becomes an avatar candidate. If there is no image, you will need to add an avatar.
V3 cards, CharX files and WEBP cards are not supported. Use a V1 or V2 PNG or JSON export for this importer.
How to import a card
- Sign in and open Create.
- Expand Advanced and find Import character card.
- Choose Pick a PNG / JSON card and select your file.
- Review the filled-in fields. Add a tagline, which every character needs, and an avatar if the card did not bring one. Check the category selection, long text and alternate greetings before continuing.
- Create the character. It uses your default visibility, or private if you have not set a default. Public characters appear in the market only after review.
A reproducible example: Nora Bell
Nora Bell is an original fictional bookseller made for this demonstration. This is a constructed sample, not a customer story or a claim about chat quality. The small geometric PNG is a file-format example, not a portrait.
The JSON sample and PNG sample contain the same complete V2 card data. In our local importer check on September 14, 2026, both produced the same text fields and categories. The PNG container also passed checks of its image dimensions, compressed image data and chunk checksums.
| In the sample card | Result in the editor's import data |
|---|---|
| Name: Nora Bell | Nora Bell |
| Description and personality in separate fields | Combined into Persona, separated by a blank line |
| A rainy-afternoon bookshop scenario | Kept in Scenario |
| A greeting asking whether the visitor wants a quiet story or a twist | Kept in Opening line, with {{user}} still present in the editable text |
| One example exchange about book preferences | Kept in Example dialogue |
| Four alternate greetings | The first three are kept; the fourth is omitted |
Tags: Original, Bookshop, 原创, 治愈, 原创 | 原创 and 治愈 are kept once each; Original and Bookshop are listed as ignored |
| World info saying the back-room clock stopped at 4:17 | Not imported |
| Separate system prompt, post-history instructions, creator notes and extensions | Not imported |
The sample uses short text, so it does not lose any text to length limits. Its JSON file has no image URL in the greeting, so it has no avatar candidate. The PNG version includes a picture for the editor's crop step.
Sample use: you may copy and adapt these original JSON and PNG files for your own character projects. The permission covers the sample files, not Soliloquy names or marks.
The tag result is easy to miss. Soliloquy currently matches the stored category values exactly; it does not translate an English tag into a category. In the English interface, 原创 is displayed as Original and 治愈 as Slice of life, but a card tag written as Original does not match 原创. Review and select the categories you want after import.
You can compare the files with the recorded field results and complete local experiment output. These results show how the importer reads the sample. They do not establish how a character will behave in conversation.
What carries over
| SillyTavern field | Becomes | Limit |
|---|---|---|
name | Name | 64 characters |
description + personality | Persona, joined with a blank line | 4,000 characters combined |
scenario | Scenario | 1,000 characters |
first_mes | Opening line; Markdown images are removed from its text | 500 characters |
mes_example | Example dialogue | 4,000 characters |
alternate_greetings | The first three nonempty alternate greetings | 500 characters each |
tags | Categories that exactly match Soliloquy's category list | Up to nine; other tags are listed after import |
Text longer than a limit is shortened to fit. Review long personas before creating the character. Some emoji take more than one position within these limits, so fewer visible characters may fit. Review long fields after import.
The opening line keeps {{user}} in the editor. When the opening is displayed in chat, it uses your persona name, or “you” if you have not set one.
What does not carry over
- Lorebooks and world info (
character_book). - The separate system prompt and post-history instructions.
- Creator notes, creator attribution, character version and extensions.
- Rating, gender and age as structured fields from the card.
- Alternate greetings after the first three, text beyond the limits and tags outside the category list.
There is no export back to SillyTavern. Keep the original file so you can refer to information that the Soliloquy editor does not import.
If the import does not look right
If a PNG has no embedded card data, download a PNG character-card export instead of a normal image. Changing an image's filename does not add card data.
If the JSON is broken, export it again. If the fields are blank, check that the card uses a supported V1 or V2 layout and fill in a missing name before creating the character. A file being readable does not mean its format is supported.
If the text is present but the avatar is missing, add an image yourself. A JSON greeting's remote image can fail to load even when the text import succeeds.
If categories are missing, choose them in the editor. English labels and free-form tags are not automatically converted into Soliloquy's stored category values.
How we checked this guide
On September 14, 2026, we ran the actual editor import functions on the two Nora Bell files and compared their complete results. We also recorded twelve constructed boundary inputs covering long fields, emoji at a limit, older V1 cards, blank names, Markdown images, alternate greetings, tag matching, unsupported V3 data and invalid files. The three existing importer test files passed all 43 tests. We also imported both files in the actual Soliloquy web editor using an isolated local browser session. The expected fields, the three retained alternate greetings and category selection appeared in the form. The PNG opened the avatar cropper; we cancelled it without uploading an avatar or creating a character.
This is a local import compatibility check. It does not test a SillyTavern application round trip, remote image loading, saved characters, conversation quality or AI search visibility. Review the imported fields before creating a character.
Want to see what is already here? Browse every public character.