Importing Prompts

Musebox allows you to bulk import prompts using a CSV file. This is useful for migrating prompts from other tools or managing large collections of prompts.

Preparing Your CSV File

Your CSV file should contain the prompts you want to import. The file must have a header row defining the columns.

Required Columns

Title: The title of the prompt
Content: The actual text of the prompt

Optional Columns

Description: A short description of the prompt
Category: The name of the category (e.g., "Writing", "Coding"). Must match an existing category name in Musebox (case-insensitive)
Private: Set to true or 1 to make the prompt private. Any other value (or leaving it blank) will make it public
Tags: A list of tags separated by semicolons (;) or commas (,)
- You can optionally specify a color for a tag using the format tag_name:hex_code (e.g., python:#3776ab)

Column Names

Column names are case-insensitive. "Title", "title", and "TITLE" will all work correctly.

Example CSV Format

Title,Content,Description,Category,Private,Tags
Blog Post Generator,"Write a blog post about {{topic}}",Generates blog posts,Writing,false,blog;content
Python Debugger,"Fix this python code: {{code}}",Debugs code,Coding,true,python:#3776ab;debug

Variables in Imports

You can include variables in your prompt content using the standard syntax ({{variable_name}} for text variables or {{{variable_name: option1, option2}}} for dropdowns). They will be automatically detected when imported.

Uploading Your File

Navigate to the Import Prompts page (usually found in the dashboard sidebar or under prompt settings)
Click on the upload area or drag and drop your CSV file
The system will parse your file and move to the mapping step

File Size

For best performance, keep your CSV files under 5MB. If you have a very large collection, consider splitting it into multiple files.

Mapping Columns

Musebox will attempt to automatically map your CSV columns to the corresponding prompt fields based on the header names.

Review the mapping for each field
Title and Content must be mapped
If a column was not detected correctly, select the appropriate field from the dropdown
Select Ignore this column for any data you don't want to import
Check the Data Preview to ensure the values look correct
Click Continue to Import when you are ready

Automatic Mapping

The system looks for common column names like "Title", "Name", "Prompt", "Content", "Text", "Description", etc. If your columns use these names, they'll be mapped automatically.

Import Process & Summary

The system will process each row in your CSV file:

Success: The prompt is created and added to your account
Error: If a row is missing required data or has invalid values, it will be skipped, and an error will be recorded

Once the import is complete, you will see a summary showing:

Total number of rows processed
Number of successful imports
Number of failed imports (with details on why they failed)

Note

Successfully imported prompts will appear in your prompt library immediately. You can edit, organize, or share them just like any other prompt.

Troubleshooting

Common Import Errors

"Title and content are required"

Ensure your CSV has columns for title and content and that they are mapped correctly. Each row must have values in both columns.

"Category not found"

The category name in your CSV must match an existing category in Musebox. If it doesn't match, the prompt will still be imported, but without a category. You can assign a category later by editing the prompt.

Encoding Issues

Ensure your CSV file is saved with UTF-8 encoding to support special characters, emojis, and international text.

"Content exceeds character limit"

Prompt content is limited to 20,000 characters. If your CSV contains longer content, split it into multiple prompts or reduce the content length.

Best Practices

Test with a small file first: Import 5-10 prompts initially to verify your CSV format is correct
Use consistent formatting: Keep your CSV structure consistent across all rows
Clean your data: Remove duplicate prompts before importing
Verify categories: Check that category names match your Musebox categories exactly
Escape special characters: Quote fields that contain commas, quotes, or line breaks

Exporting and Re-importing

You can export your existing prompts to CSV and then re-import them with modifications:

Export your prompts from the prompts library (if this feature is available)
Make changes to the CSV file
Delete the old prompts (if needed)
Re-import the modified CSV

Duplicate Prevention

Musebox doesn't automatically detect duplicates during import. If you import the same prompts twice, you'll have duplicates. Make sure to clean up old prompts before re-importing.

Advanced CSV Features

Multiline Content

To include line breaks in your prompt content, wrap the field in quotes:

Title,Content
"Blog Post","Write a blog post with:
1. Introduction
2. Main points
3. Conclusion"

Special Characters

To include commas, quotes, or other special characters in your fields:

Commas: Wrap the field in quotes
Quotes: Use double quotes ("") to escape quotes within quoted fields
Line breaks: Wrap the field in quotes

Example:

Title,Content
"Prompt with comma","This is a prompt, with a comma"
"Prompt with quote","This prompt has a ""quoted"" word"
"Multiline prompt","Line 1
Line 2
Line 3"

Next Steps

Need Help?

If you're having trouble with CSV imports, check the import summary for specific error messages or contact support at support@musebox.io.