Bulk Creation & CSV Import

If you have a lot of entities to add — a cast of characters, a list of locations, or data from another tool — MythTapestry offers two batch methods.

Bulk creation

The bulk creation modal lets you create multiple entities quickly by typing comma-separated names.

1. Go to Entities in the world sidebar.
2. Click Bulk Create (or press Ctrl+Shift+E).
3. Choose an entity type for the first group.
4. Enter comma-separated names in the text area (e.g. “Alice, Bob, Charlie”).
5. Optionally click Add Another Type to create a second group with a different type.
6. Review the entity count shown at the bottom.
7. Click Create All.

How it works

• Names are split by commas and trimmed of whitespace
• Each group uses a single entity type
• You can have multiple groups with different types in one batch
• Duplicate names (same name + same type) are skipped
• Maximum 500 entities per bulk request
• All entities are created with default field values — edit them individually afterwards

Tip

The entity count updates live as you type, so you can see exactly how many entities will be created before submitting.

CSV import

For larger datasets or when you want to populate fields beyond just the name, use CSV import.

1. Go to Entities and click Import.
2. Select an entity type from the dropdown.
3. Optionally click Download Template to get a CSV with the correct headers, format hints, and an example row.
4. Upload your .csv file (max 10 MB, UTF-8 encoding).
5. Click Preview Import to validate the data.
6. Review the preview: total rows, valid rows, invalid rows, and any validation errors.
7. Click Import to create the entities.

Template download

The template CSV includes three rows:

1. Headers — field names matching the entity type’s schema
2. Format hints — field types and constraints for each column
3. Example row — sample data showing the expected format

Preview mode

Before importing, the preview shows:

• Stats cards: Total rows, valid rows (green), invalid rows (red)
• Validation errors: Row number, field name, and error reason (first 10 shown, with a “+X more” indicator)
• Sample entities: First 5 rows with Name, Type, and field count

You can reset and choose a different file if the preview reveals problems.

CSV format

Your CSV needs at minimum Type and Name columns (case-insensitive):

Type,Name,Description
Character,Aldric Voss,A rogue knight seeking redemption
Character,Elena Bright,Court mage of the Eastern Reach
Location,The Crimson Tower,An ancient fortress in the northern wastes

Additional columns are mapped to entity fields based on the entity type schema. Unrecognised columns are ignored.

Handling duplicates

If an entity with the same name and type already exists, the import skips it and reports it in the results summary.

Note

The enhanced CSV import validates each row against the entity type’s field schema. Invalid values (wrong types, out-of-range numbers, unrecognised enum options) are flagged in the preview with specific error messages.