NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.

Why your Nether portal links to the wrong portal

It is not random. The game converts your position, looks for the nearest portal, and only builds a new one if it finds none.

By the Block Shape Generator team. Updated 12 November 2026.

Players often build a Nether portal, walk through, come back, and land somewhere else, or find that 2 bases share one portal. Mojang's own bug tracker has dozens of reports of this marked "Works As Intended", because the rule is simple once you know it.

The rule in 3 steps

  1. Convert. Going into the Nether, your X and Z are divided by 8. Coming back, they are multiplied by 8. Y stays the same.
  2. Search. The game looks for an existing portal near that converted point. In Java Edition it searches about 128 blocks around it in the Overworld and about 16 blocks around it in the Nether.
  3. Pick or build. It uses the closest portal it finds. If there is none, it builds a new portal at the nearest safe spot.

Try it with the Nether portal calculator: type your Overworld coordinates and it shows the exact Nether point, and the link checker tells you whether 2 portals will connect.

Why it goes wrong

How to link 2 portals on purpose

  1. Build your Overworld portal and write down X, Y and Z (F3 in Java, Show Coordinates in Bedrock).
  2. Divide X and Z by 8 with the calculator.
  3. Go to the Nether and build a portal at exactly that point, at a similar Y level.
  4. Light it, walk through, and check you arrive at your Overworld portal. Then go back and check the other direction.
  5. Break any portal the game built on its own nearby, so it cannot steal the link later.

Need obsidian for the frame? The calculator also counts it for any portal size, with or without the 4 corners.

Sources

Questions

Why did my portal make a new portal instead of using mine?

When no portal is found near the converted point, the game builds a new one. Mojang's bug tracker marks this behaviour as working as intended. Build your second portal at the exact converted coordinates and break the extra one.

How far apart should 2 Overworld portals be?

In Java Edition keep them more than 128 blocks apart on X or Z, and build each Nether portal at its own exact point, so their search areas do not pick the same portal.

Does the Y level matter?

Y is not divided by 8, but guides disagree on how much it counts when the game picks between 2 nearby portals. Matching the Y level of both portals removes the doubt.