Hardware FixRecommendedDevice not working? Your driver may be the problemCheck updates for common hardware issues.Fix DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan Now×
Skip to content
VGSources
Bedrock Edition

How to Add a Custom World to Your Minecraft Realm

Upload an existing Bedrock or Java world to a Realm with the right edition-specific steps. Learn how to use slots, back up the old world and fix common upload problems.

By VGSources Team 7 min read
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

You can upload an existing world to a Minecraft Realm, but the steps depend on whether you play Bedrock Edition or Java Edition. Before replacing a world, download a copy of the current Realm: replacing a slot does not merge worlds, and Realm backups are not a permanent archive.

First check the edition. Bedrock players can upload a compatible local world through the Realm’s world slots; Java players use the Realm’s Configure and Worlds controls. A Java world cannot be uploaded directly to a Bedrock Realm, or vice versa.

Before you upload a world

  • Match editions. Bedrock Realms are for Bedrock worlds and Java Realms are for Java worlds. Realms cross-play works within an edition, not between Java and Bedrock. See Minecraft Realms for edition details.
  • Use an active Realm. Uploading through Realms requires an active trial or subscription. Mojang recommends updating Minecraft on both devices when transferring a Bedrock world; see its Bedrock transfer guidance.
  • Test the local world first. Open it, check that it loads, then exit normally so its latest changes are saved. Make a separate local copy before uploading.
  • Download the Realm world you might replace. Replacement changes the world in that slot; it does not combine it with the upload. Mojang advises downloading the current world first and warns that backups may not be retained indefinitely. See Change Your Realm World.
  • Plan for players to pause. Ask invited players to leave while the replacement is underway so nobody makes progress in the world being changed.
  • Check the content and size. Bedrock uploads have a stated 4 GB maximum. World data can include more than terrain, such as player data, structures, maps, add-ons and pack data. This limit is specific to Bedrock uploads, not Java Realms. See Mojang’s Bedrock upload guide.

The Realm owner, or an account with the necessary Realm-management access, should do the upload. An invited member can play but should not assume they can replace a world.

Add a custom world to a Bedrock Realm

These steps apply to Bedrock Edition on supported platforms, including Windows, mobile, Xbox, PlayStation, Switch and Chromebook. Menu wording can vary slightly between platforms and game updates. The key distinction is that an empty slot uses Upload World, while an occupied slot uses Replace World.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
#1 Best Overall
Minecraft | 1,720 Minecoins Pack | Digital Code
  • Minecoins let you buy Minecraft content you can enjoy on your Android, iOS, Windows 10, Xbox One and Nintendo Switch devices*
  • Visit the in-game Minecraft marketplace, where you'll discover a constantly updating library of exciting new Minecraft content - from a community whose imagination knows no limits.
  • Once you've redeemed your Minecoins, they'll be linked with your Xbox Live account, so you can access your coins and purchases through all of your supported devices that run Minecraft.
  • Minecoins are a perfect gift for Minecraft players!

Upload to an empty slot

  1. Launch Minecraft and select Play.
  2. Open the Realms tab and enter the Realm’s Realms Hub.
  3. Open Worlds, then Slots, and select an empty slot.
  4. Select Create World. At the bottom of Game Settings, choose Upload World.
  5. Select the local world and wait for upload and any conversion to finish.
  6. If needed, activate that slot so it becomes the world players enter.

Bedrock Realms can store up to three worlds, but only one is active and playable at a time. The upload path and limit are documented in Mojang’s upload instructions; slot information is on the Realms page.

Replace a world in an occupied slot

  1. Open Play → Realms → the Realm’s Realms Hub.
  2. Select Worlds → Slots, then choose the occupied slot.
  3. Choose Edit World, scroll to the bottom of Game Settings, and select Replace World.
  4. Choose the local world and confirm the replacement.
  5. Wait for the upload to finish. Enter the Realm yourself and check the result before inviting players back in.

Replacing a slot overwrites that slot’s world; it does not bring its builds or player progress into the uploaded save. Download the existing world before starting. For a separate copy, use the Realm slot’s download controls; Mojang’s Bedrock download guide covers downloading a Realm world.

Add a custom world to a Java Realm

For Java Edition on Windows, macOS or Linux, use the Realm’s configuration screen. The stable landmarks are Minecraft Realms → select the Realm → Configure → Worlds; exact button labels can change with the interface. Mojang documents the management controls in Manage Settings for a Java Realm.

  1. Launch Minecraft: Java Edition and select Minecraft Realms.
  2. Select the Realm, then choose Configure.
  3. Open Worlds and select the slot you intend to change.
  4. Use the reset or replace control for that slot, then choose the option to upload a world.
  5. Select the local Java world and confirm. If the file picker asks for a folder, choose the world folder itself—not an unrelated parent folder or a compressed archive.
  6. Wait for the upload to complete, enter the Realm, and check the spawn point, inventories, builds, advancements and player access.

A typical Java world folder contains level.dat, a region folder and often playerdata, DIM-1 or DIM1; contents vary. Back up the world before opening it in another version. A world saved in a newer Minecraft version may not work in an older one, and downgrading can damage or remove version-specific data. Test datapacks and command systems in the version used by the Realm.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Minecraft | 8,800 Minecoins Pack | Digital Code
  • Minecoins are Minecraft’s in-game currency, spendable via the Minecraft Marketplace
  • With Minecoins, you can purchase content that adds variety to your gameplay and experiences (including server partners) across selected Minecraft games
  • Gain access to an ever-expanding library of exciting content, crafted by community creators
  • Add more cuteness, comedy, or chaos to your Bedrock worlds with Add-ons. Explore a catalog of custom blocks, items, mobs, recipes and other unique content. Add-ons are the easiest way to change your game, your way.
  • Change the look of blocks, biomes, and even your favorite Minecraft mobs by purchasing unique texture packs and expand your in-game wardrobe by purchasing new skins and Character Creator items.

What kinds of custom worlds can you use?

Worlds you made or downloaded maps

A local world you created or a downloaded map is usually the straightforward case if it is for the same edition, compatible with the current game version and appears in the local Worlds list. Import the file into Minecraft first, open it locally to test it, then upload it. A map’s successful upload does not guarantee that every external pack or tool used to create it will work on the Realm.

Marketplace worlds and templates

On Bedrock, you can create a local world from a Marketplace template or other supported content and then upload that world. Marketplace access is a Bedrock content route, not a way to convert a world to Java; Java Realms do not support the Bedrock Marketplace. See the official Realms information.

Bedrock add-ons

Add-on behavior depends on the add-on, game version and how its resource and behavior packs are associated with the world. Before inviting friends, check that the packs are enabled, present and compatible with the current Bedrock version, and that players can use or download any required content. Do not assume every third-party add-on will work on Realms; some world settings or content can also affect achievements.

Java datapacks, mods and plugins

A vanilla-compatible Java map may upload even if the setup used to make it cannot run on Realms. A standard Java Realm is not a general-purpose host for Forge, Fabric, NeoForge, custom server jars, or server-side plugins. Datapacks and command-driven maps should be tested after upload, especially functions, scheduled commands, scoreboards, loot tables, advancements, structures, resource-pack dependencies and command-block behavior.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Minecraft | Java & Bedrock Ultimate Collection | Windows Digital Code
  • ULTIMATE COLLECTION — Includes the base game, five add-ons (Celebration Food, Rescue Dogs, Plenty O’ Blocks, Decocraft, and Weapons + Tools), five exclusive Character Creator items, and 1000 Minecoins.
  • CREATE — Build whatever you can imagine in your own infinite world that’s unique in every playthrough.
  • EXPLORE — Discover biomes, resources, and mobs, and craft your way through a world filled with surprises in the ultimate sandbox game.
  • SURVIVE — Experience unforgettable adventures as you face mysterious foes, traverse exciting landscapes, and travel to perilous dimensions.
  • PLAY TOGETHER — Have a blast with friends, whether you’re sitting on the same couch in split screen or miles apart in cross-platform play for console, mobile, and PC.

Back up the Realm and recover from a bad upload

For Bedrock, open the Realm’s Worlds → Slots, select the current world and use its download control. Verify that the copy appears in the local Worlds list. If an upload goes wrong, Bedrock Realm backups may allow you to restore an earlier automatic or manual save; see Mojang’s restore instructions.

For Java, use the Realm’s download or backup controls before replacing the world. The Java management page covers backups and downloading or restoring a world: Manage Settings for a Java Realm.

If the new world is wrong or important progress is missing, stop playing in it, leave the Realm, and download or restore the previous world before trying again. Check that you chose the intended slot and the correct local save. A backup can help, but Mojang cautions that Realm backups are not retained indefinitely, so keep an independent copy of worlds that matter.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Troubleshoot upload problems

The upload or replace option is missing

  • Confirm you opened Realm management rather than the local-world menu.
  • On Bedrock, check Realms Hub → Worlds → Slots; on Java, check Minecraft Realms → Configure → Worlds.
  • Make sure you have the required Realm-management access, the correct edition and an active trial or subscription.
  • Check whether the selected slot is empty or occupied: the upload and replacement controls differ.

The world does not appear in the picker

  • Import it into the device’s Minecraft installation first and open it locally.
  • Confirm it belongs to the same edition as the Realm.
  • If using Java, select the actual world folder; do not leave the map compressed if Minecraft expects an imported world.
  • Keep the original file untouched. If the world still does not appear, re-import it or test with a known-good save.

The upload fails or stalls

  1. For Bedrock, check whether the world exceeds the documented 4 GB upload maximum.
  2. Restart Minecraft and install the latest available game update.
  3. Check that the device has free storage and the connection is stable.
  4. Open the world offline to check for corruption, then try a separate copy or another slot.
  5. Do not repeatedly replace the live world without a backup.

If a world exceeds the Bedrock limit, reduce its size only with a method suitable for your platform and world; removing chunks is not guaranteed to solve every oversized upload.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #4
Minecraft | Standard Edition | XBOX Digital
  • Create and shape an infinite world, explore varied biomes filled with creatures and surprises, and go on thrilling adventures to perilous places and face mysterious foes.
  • Play with friends across devices or in local multiplayer.
  • Connect with millions of players on community servers, or subscribe to Realms Plus to play with up to 10 friends on your own private server.
  • Get creator-made add-ons, thrilling worlds, and stylish cosmetics on Minecraft Marketplace; subscribe to Marketplace Pass (or Realms Plus) to access 150+ worlds, skin & textures packs, and more—refreshed monthly.

The world loads but players spawn or appear incorrectly

Test the Realm as the owner before everyone rejoins. Check world spawn, individual player locations and inventories, gamerules, permissions, command blocks and any packs or datapacks the map needs. A world’s saved player data and settings come from the uploaded save, not from a merge with the former Realm world.

The previous Realm world seems missing

Check whether it is still stored in another slot, whether you downloaded a local copy, and whether a Realm backup is available. Do not assume a backup will remain available indefinitely; download important worlds for long-term safekeeping.

When Realms is not the right host

Realms is a practical choice for a private, always-online world when the group uses one edition and wants official hosting without managing server software. Invited friends can play without buying their own Realm subscription, and Realms offers world management and backups; see Minecraft’s Realms page.

Consider a dedicated server instead if the world requires a mod loader, plugins, custom server software, full file access, advanced configuration or a world that exceeds Bedrock’s upload limit. A self-hosted or third-party server gives more control but also means more setup, maintenance, backup responsibility and potentially separate hosting costs. For occasional play, local multiplayer avoids a Realm subscription, but the host device and network must be available.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Quick Recap

Bestseller No. 1
Minecraft | 1,720 Minecoins Pack | Digital Code
Minecraft | 1,720 Minecoins Pack | Digital Code
Minecoins are a perfect gift for Minecraft players!
$9.99
Bestseller No. 2
Minecraft | 8,800 Minecoins Pack | Digital Code
Minecraft | 8,800 Minecoins Pack | Digital Code
Minecoins are Minecraft’s in-game currency, spendable via the Minecraft Marketplace
$49.99
Bestseller No. 4
Minecraft | Standard Edition | XBOX Digital
Minecraft | Standard Edition | XBOX Digital
Play with friends across devices or in local multiplayer.
$19.99

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from Patch Notes

Recommended PC Tool
Recommended PC Tool
Outdated Drivers Are Slowing You DownFree scan - exact matches
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.