Sharing

Importing
Import File at the bottom of the Story Library is used to import anything created by NovelAI with the exception of themes. This means: .txt, .story, .lorebook or .scenario files. Alternatively, you can drag & drop these files to the main text box to import them.

.preset files must be imported directly from the Config Preset's Import menu, not the Import menu at the bottom of the Options tab.

Text and File Export
You can export a story as a .story file by clicking the 📩 button when selecting it in the Story Library.

At the bottom of the Story Tab in the settings menu, you'll find various options for saving and loading stories and other data, by clicking on arrow next to To File, you will be able to export to different file formats.


 * Duplicate Story creates a copy of the story in your library and switches to it. The story will have "- Copy" appended to its name.


 * Export Generation Settings exports only the AI settings you have currently selected. This is useful if you find settings you believe are worth sharing.


 * To File allows you to download the story as a .story file, ready for import to NovelAI.


 * As Scenario allows you to download the story as a .scenario file, which will prompt the user to fill placeholders. on import.


 * As Plaintext allows you to download the story as a .txt file, removing all other data (generation settings, etc).


 * To Clipboard will fill the clipboard with the complete JSON content of the story to your clipboard, which can cause a long processing delay on your computer.


 * As Image opens the Screenshot Designer.

Generation Setting Export
You can export generation settings by clicking Export next to Config Preset at the top of the settings tab.

Exporting Lorebooks
You may export the entire story Lorebook as a .lorebook file by clicking the 📥 Export Lorebook button at the top left of the Lorebook window.

---

Screenshot Export


The Screenshot Designer is accessed by clicking As Image in the export dropdown.

The Screenshot Designer helps you create neat visual snippets of your story for sharing on social media, chat services, and much more. There are many elements that can be toggled for your convenience.


 * Show Title toggles the display of the story title at the top of the image.


 * Show Date toggles the display of the date at which the screenshot was taken.


 * Show Pen Name toggles the display of your Pen Name as set in your Account Settings.


 * Show NAI Logo toggles the display of the logo and URL of NovelAI at the bottom of the image.


 * Show Color Highlighting toggles the display of Prompt/User/AI/Modified text highlighting.


 * Show Color Legend (if above is enabled) toggles the display of a legend showing which color represents which type of input.


 * Show AI Model toggles the display of "Written alongside" and the portrait of the AI model in use.


 * Show Background toggles the display of background graphical fluff to the image.

⬆ Return to Page Top

Defining Comments
Any line preceded by two pound signs without a space,  are considered comments and will not be read by the AI, which you can use to give information to your end user.

Importing
You can create exportable scenarios from the options menu as well as importing them the same way you import a story, by dropping the file on the webpage or by clicking on the import story button when creating a new story.

NOTE: If you are on IOS, you may encounter issues importing files. Rename the extension to .json to fix this issue.

Importing a scenario with placeholders
When importing a scenario, you may be asked to fill in some information. Those are called placeholders. You can simply edit those fields to your liking.



Turning on Import Settings will import the Generation settings that were used by the Scenario author.

Adding a placeholder
You can add a placeholder anywhere within your story's prompt, memory, author's note and lorebook entries.

Placeholders have to be written in this format:. The placeholder is divided into five parts:


 * order: the order in which the placeholders will be displayed. 1 goes first, then 2, etc.
 * id: the only mandatory part of the placeholder, it has to be unique. If you have more than one instance of the id, it will use the same value for each of the placeholders.
 * default: the default content of the field when importing the value.
 * title: The title used in the placeholder import window to tell the user what they need to fill in.
 * description: the text displayed above the input field when importing the value. If there is no description set, the text displayed will be the id. You may want to word this like a question for ease.

'''You cannot put these characters inside the text fields of the placeholder: $ {} [] # : @ ^ |

Note for the lorebook entries
For the lorebook entries, you can add placeholders on the title of an entry, its descriptions and its keys. If you want to use regex for your keys, you have to prefix the expression with a  for example to match with the name of a character, you have to write

Placeholder-filling Order
Placeholders are requested to be completed by the user in the alphabetical order of their ID. This means that if you start their id with a number that increments with each placeholder, they will be requested in the order of that number.

Example: Job will be requested before Gender, because its ID comes before it.

You can also define the order by preceding the id with a number, followed by a pound sign (#):

If different entries have the same Order number, they will be processed alphabetically according to their id.

Placeholder Table of Contents
You can create a Table of Contents for placeholders where you can insert a large amount of them in advance, allowing you to easily keep track of all the placeholders you have defined.

The syntax is identical to normal placeholders, with these notable differences:


 * It must be inserted at the absolute top of the prompt.
 * The initiating symbol is a percentage sign (%) rather than a dollar sign.
 * Every Placeholder must be on its own new line.



⬆ Return to Page Top

Formats
Formats are different ways of writing Memory, Author's Note and Lorebook entries. Contributor Valahraban wrote an extensive research report on several formats, which goes into great details into various formats, their utility, and how to use them.

'''NovelAI does not recommend, endorse, or otherwise support any format type in particular. Neither does the Unofficial knowledge base.'''

⬆ Return to Page Top

-