How Nether Portals Link

Updated 2026-09-26 · MC Seed Maps

Nether portals link by coordinates: the game divides your Overworld X and Z by 8 (rounding down) to get the Nether target, and multiplies Nether X and Z by 8 to go back, then uses the closest existing portal near that spot. If no portal is close enough, it builds a new one, which is why portals sometimes link to the "wrong" place. Our Nether portal calculator does the math for you.

How do Nether coordinates convert to the Overworld?

One block in the Nether equals eight blocks in the Overworld, horizontally. The Minecraft Wiki gives these formulas:

Going from Formula Y level
Overworld to Nether X ÷ 8 and Z ÷ 8, rounded down Unchanged
Nether to Overworld X × 8 and Z × 8 Unchanged

Some worked examples (these are only arithmetic, not places in a real world):

Overworld X, Z Nether X, Z
800, 1600 100, 200
1003, -40 125, -5
-100, 20 -13, 2

Notice the last row. "Rounded down" means toward negative infinity, so -100 ÷ 8 = -12.5 becomes -13, not -12. This catches a lot of players out on negative coordinates. The Nether portal calculator handles the rounding for you.

When you step through a portal, the game works out the target position in the other dimension, then looks for an existing portal near it. On Java Edition the search works like this:

Where you arrive Search area (Java) Height
Overworld 256×256 blocks, a 128-block radius around the target Full height
Nether 32×32 blocks, a 16-block radius around the target Full height

If one or more portals are inside that area, the game picks the closest one by straight-line (Euclidean) distance. That includes the vertical difference, so a portal far above or below can lose to one at the right height.

On Bedrock Edition, the wiki gives a 128-block radius in both dimensions.

On Java Edition, the game then tries to build a new portal:

  1. It looks for a valid spot within 16 blocks horizontally of the target, at any height.
  2. A valid spot needs a 3×4 area of solid blocks you could build on, with 4 blocks of air above it.
  3. If it finds no valid spot, it forces a new portal at the target anyway and places a 2×3 obsidian platform for it to stand on.

This is how you end up with a portal floating over a lava lake or sticking out of a Nether wall. It is not a bug; the game simply had nowhere better to put it.

Most linking problems come from the search areas above. The common cases:

Two Overworld portals share one Nether portal. The Overworld search is big (128 blocks), but the Nether one is small (16 blocks). When two Overworld portals are fairly close together, their Nether targets end up close too, and both can find the same Nether portal.

The Nether portal sends you to an old Overworld portal. When you come back, the game searches 128 blocks around the target in the Overworld. If an older portal is closer to that target than the one you built, you arrive at the older one.

A new portal appeared instead of linking. No portal was inside the search area, so the game built one. This often happens when you build the Nether side by eye instead of at the exact coordinates.

The reliable method is to build both sides at matching coordinates:

  1. Stand in your Overworld portal and note its X, Y and Z.
  2. Enter them into the Nether portal calculator to get the Nether position (X and Z divided by 8, rounded down; same Y).
  3. Go through the portal. If it created a new portal far from that position, walk to the calculated coordinates.
  4. Build your own portal there, as close to the calculated X, Y and Z as you can.
  5. Break the portal the game generated, if you do not need it, so it cannot steal the link.
  6. Walk back through your new portal and check that you arrive at your original Overworld portal.

For a second base, repeat this with the second pair. Keep your Nether portals more than 16 blocks apart where you can, and your Overworld portals spread out so their Nether targets do not overlap.

Can I use Nether portals to travel faster?

Yes. Because every block you walk in the Nether covers eight in the Overworld, a Nether tunnel between two portals is a big shortcut. To connect two distant Overworld bases:

  • Convert both base coordinates with the calculator.
  • Build a portal at each base.
  • Build the matching portals in the Nether and connect them with a tunnel or path.

To plan the Overworld side, the seed map can show you biomes and structures around each base. Switch it to the Nether dimension to see Nether biomes and structures near your planned tunnel. Positions on the map are predictions from world generation; confirm important spots in-game with /locate structure minecraft:<id>.

Is portal linking the same on Java and Bedrock?

The coordinate math is the same: divide by 8 into the Nether, multiply by 8 out of it. The search area differs. Java searches 128 blocks around the target in the Overworld but only 16 blocks in the Nether, while the wiki gives Bedrock a 128-block radius in both dimensions. So a pair of portals that links cleanly on Bedrock can behave differently on Java, where the smaller Nether search makes exact placement more important.

Quick summary

  • Overworld to Nether: X ÷ 8 and Z ÷ 8, rounded down. Nether to Overworld: X × 8 and Z × 8. Y stays the same.
  • Java searches 128 blocks around the target in the Overworld and 16 blocks in the Nether, full height; Bedrock searches 128 blocks in both.
  • The closest portal wins, measured in straight-line distance.
  • No portal nearby: the game builds one, and may add a 2×3 obsidian platform.
  • Build both sides at calculated coordinates with the Nether portal calculator to avoid bad links.

Frequently asked questions

How do I calculate Nether coordinates?

Divide your Overworld X and Z by 8 and round down. Y stays the same. To go back, multiply your Nether X and Z by 8.

How far does a Nether portal search for another portal?

On Java Edition, the game searches a 256×256 area (128 blocks from the target) in the Overworld and a 32×32 area (16 blocks from the target) in the Nether, over the full height. On Bedrock, it searches 128 blocks in both dimensions.

Why did my portal create a new portal instead of linking?

No existing portal was inside the search area around the target position, so the game built a new one. Build your partner portal at the exact converted coordinates to fix it.

Why do two of my portals go to the same place?

The game picks the closest portal inside the search area. If both Overworld portals convert to spots near the same Nether portal, both will use it.

Does Y matter when linking portals?

Y is not scaled, and the search covers the full height, but the game uses the closest portal by straight-line distance, so height still affects which portal wins.

Sources: minecraft.wiki/w/Nether_portal