BackHelp Center

How do I import from Roll20?

Import campaign data from Roll20 into SwiftPrep.

Status: Coming Soon

Roll20 import is currently in development. This page will be updated when the feature is available.

[!INFO] Want to be notified when Roll20 import is available? Sign up for the SwiftPrep newsletter at swiftprep.app or watch for in-app update notifications.

Planned Features

When released, Roll20 import will support:

What Will Import

Roll20 ContentSwiftPrep Entity
CharactersNPC or PC entities
HandoutsPlot hooks, items, or notes
Journal contentVarious entity types

Expected Workflow

  1. Export data from Roll20 using Roll20's export feature
  2. Select the export file in SwiftPrep import wizard
  3. Preview what will import
  4. Import and review content

Prepare for Import

While waiting for this feature, you can prepare your Roll20 game:

Organize Your Roll20 Game

Take time to clean up:

  • Clean up unused characters and handouts
  • Organize journal entries into folders
  • Archive old content you do not need
  • Note content that is essential to import

Export What You Can

Roll20's export options may be limited, but consider:

  • Copy important handout text manually
  • Export character sheets if available
  • Screenshot or copy key information
  • Keep a master list of content you want to transfer

[!TIP] Start a document with the key NPCs, locations, and story threads from your Roll20 game. This will make manual entry faster if you want to start using SwiftPrep before import is available.

Alternative: Manual Entry

While waiting for Roll20 import, you can start building in SwiftPrep:

Transfer Key Content Manually

  1. Create entities manually in SwiftPrep
  2. Copy content from Roll20 handouts
  3. Use AI to help flesh out sparse entries
  4. Build relationships as you go

This takes more time but gives you full control over how content is organized.

Focus on Active Content

Do not try to transfer everything at once. Focus on:

  • NPCs appearing in your next 2-3 sessions
  • Locations the party is currently exploring
  • Active plot threads and quests
  • Key items and encounters

You can add historical content later as needed.

What Roll20 Import Will Look Like

Based on how other VTT imports work, Roll20 import will likely follow similar patterns.

Export from Roll20

You will need to export your game data from Roll20. The exact process will depend on what export options Roll20 provides.

Import Process

  1. Open SwiftPrep Settings > Import
  2. Select Roll20
  3. Select your exported file
  4. Preview entities to import
  5. Configure options
  6. Import and review

Post-Import Tasks

After import, you will want to:

  • Review imported content for accuracy
  • Add relationships between entities
  • Tag content for organization
  • Enhance sparse entries with AI generation

Frequently Asked Questions

When will Roll20 import be available?

We are actively developing Roll20 import support. Check the SwiftPrep changelog or newsletter for announcements.

Will compendium content import?

Import will focus on content you have created or customized. Licensed compendium content likely will not import due to licensing restrictions.

What about Pro features and API scripts?

API scripts and dynamic features are Roll20-specific and will not import. SwiftPrep focuses on narrative content like NPCs, locations, and story elements.

Do I need a Roll20 subscription?

The export features needed for import may require certain Roll20 subscription levels. Details will be provided when the feature is released.

What about multi-page games?

We plan to support importing from games with multiple pages. Map layouts themselves will not import, but journal and character content will.

Manual Transfer Tips

If you want to get started with SwiftPrep before Roll20 import is available:

Characters to NPCs

For each important NPC in Roll20:

  1. Create a new NPC in SwiftPrep
  2. Copy the bio and GM notes
  3. Copy any relevant stats
  4. Add tags for organization

Handouts to Entities

Handouts can become different entity types:

  • Location descriptions become Location entities
  • Quest handouts become Plot hooks
  • Item descriptions become Item entities
  • Lore documents become notes in the Session Plan

Use AI Enhancement

After manual transfer, use AI features on Companion/Power tiers to:

  • Generate missing details
  • Expand sparse descriptions
  • Suggest relationships
  • Create consistent voice and tone

Stay Informed

To get notified when Roll20 import is available:

  • Sign up for the SwiftPrep newsletter at swiftprep.app
  • Watch for in-app update notifications
  • Check the changelog after updates

Related Articles

Was this article helpful?