How to Import a Character Card on Keoby.org

Introduction

Keoby.org helps you organize the characters that populate your worlds, games, or stories through Character Cards. If you’ve created a card elsewhere or received one from a collaborator, importing it into Keoby.org can save time and keep your library neatly organized. This guide walks you through the main ways to import a Character Card and offers tips to ensure the process goes smoothly.

Before you begin: prerequisites

• You’ll need an active Keoby.org account and access to the Card management area.
• Have your Character Card ready in a supported format. Common options include a structured file (like CSV or JSON) or data you can paste into an import form.
• If you’re importing from a team or project, check that you have the necessary permissions to add cards to the shared collection.

Import options at a glance

Keoby.org typically offers two primary import methods:

• Upload a file: Use a prepared data file that contains one or more Character Cards.
• Paste data: Use a text field to paste in a formatted card or a set of cards. In both cases, you’ll map the data fields in your file or paste to Keoby’s card schema during the import setup. This mapping ensures the name, background, abilities, and other attributes land in the right places.

Step-by-step: Importing from a file

1. Sign in and navigate to Card Management

• Open Keoby.org and go to the area where you manage Character Cards. This is often labeled something like Cards, Library, or Characters.

2. Start the import

• Look for a button or link labeled Import, Import Card, or Add Cards. Click it to initiate the process.

3. Choose the file-based method

• Select the option to upload or import from a file. You’ll be prompted to locate the file on your device.

4. Select your file and confirm format

• Upload a file that follows Keoby’s accepted formats (commonly CSV or JSON). If there are format requirements, a short on-screen note will guide you. If you’re unsure, choose a simple template with basic fields first.

5. Map the fields

• You’ll see a field-mapping screen. Map your file’s columns to Keoby’s card fields, such as Name, Role/Title, Species, Background, Abilities, Attributes, Tags, and Image URL.
• If a field is optional in Keoby, you can leave it unmapped. If a required field is missing, the tool will flag it.

6. Validate and import

• Run a quick validation to catch missing or misnamed fields. Resolve any highlighted issues, then confirm the import.
• The system will process the file and add the new Card(s) to your library.

7. Review after import

• Open the newly imported card to verify that the data appears correctly and that images or links render as expected.
• If you’re importing multiple cards, skim a few to ensure consistency across the set.

Step-by-step: Importing by pasting data

1. Start the same way

• Open Card Management and choose Import, this time selecting the paste-data option.

2. Prepare your data for pasting

• Prepare a block of text that follows Keoby’s expected structure, such as a row-per-card format with fields separated by delimiters (for example, commas or tabs) as the interface requires.

3. Paste and map

• Paste the data into the provided field. Map each field to the corresponding card attribute, just as you would with a file.

4. Validate and import

• Run validation to catch issues, correct them if needed, and complete the import.

5. Verify the results

• Open a few of the newly added cards to confirm they render correctly and that all key fields are populated.

After import: editing and validation

• Review essential fields: name, background, and core attributes. Correct any typos or misalignments you notice.
• Attach or verify images: ensure image URLs are valid or upload an image if the card supports direct image attachment.
• Organize into collections or playlists: place the new card into a relevant group so you can find it again quickly.
• Add notes or tags: labels like “Protagonist,” “NPC,” or “villain” help you filter later.

Common issues and tips

• Missing required fields: If the import flags a missing Name or another required field, add it in the source file or paste data, then re-import or update the card manually after import.
• Mismatched field names: If you see misaligned data after import, revisit the mapping step. Consistency in your source file makes this smoother.
• Large imports: For large batches, consider importing in smaller chunks to isolate problems more easily.
• Invalid images or links: If an image URL doesn’t load, replace it with a valid URL or upload a file if the platform supports it.
• Duplicates: Some setups warn about duplicates. If you’re re-importing a card, check for existing entries to avoid duplicates.

Best practices for a smooth import

• Start with a template: If available, use a Keoby-provided template to minimize mapping issues.
• Keep data consistent: Use uniform field names and formats across all cards to speed up future imports.
• Validate in small steps: Import a single card first to verify your workflow before loading a larger batch.
• Document your process: Keep a quick-reference note on the fields you use most often and how you map them.

Conclusion

Importing a Character Card into Keoby.org can be quick and reliable when you prepare your data thoughtfully and follow the mapping steps carefully. Whether you import from a file or paste data, the key is to align your fields with the card schema, check for completeness, and review the result after import. With a bit of setup, your character library will be ready to explore, search, and share with collaborators.