Quick answer

Current live-game guidance
Step-by-step guide

What to do first

Two portals connect through the same case-sensitive tag. Under normal world settings, a wood portal blocks restricted cargo such as metal; entering a stone portal allows that cargo, even if the exit is wood. Check the entry portal, not just the destination. If the portal is unconnected, investigate tags and the other endpoint before blaming your inventory.

Applies to: Live 0.221.12 through Ashlands; check world settings and mods.Last verified: September 4, 2026

Build the portal you actually need

PortalMaterialsNearby construction station
Wood portal20 fine wood, 10 Greydwarf eyes, 2 Surtling coresWorkbench
Stone portal30 grausten, 10 Greydwarf eyes, 2 molten coresStonecutter

Stone portals belong to the Ashlands resource tier. If you are making your first Swamp iron trip, do not plan around a stone portal you cannot yet build. Bring a ship, arrange local smelting, or deliberately choose different world settings.

Metal transport depends on the entrance

EnterExitRestricted metal allowed at normal settings?
WoodWoodNo
WoodStoneNo
StoneWoodYes
StoneStoneYes

A one-way success does not prove the return trip accepts the same cargo. Two stone endpoints make transport straightforward in both directions. Under normal settings, check the crossed-out portal icon on items if the game refuses to teleport you.

Diagnose the message before changing anything

  1. 1

    Unconnected: check both endpoints still exist and have exactly matching capitalization and spacing. Give the pair a distinctive tag rather than sharing one tag among several portals.

  2. 2

    Recently renamed: allow the link to update before walking through. Recheck the destination tag if it still does not connect.

  3. 3

    Connected but travel is blocked: inspect your inventory and the entry portal type. Removing metal is different from fixing a missing link.

  4. 4

    Portals disabled: ask the host about world modifiers, including no-portals or boss-related restrictions.

  5. 5

    One endpoint is gone: use your travel backup. A portal at home cannot connect to a destination that was destroyed.

Before sailing, leave a named endpoint at home and carry the materials for its partner. Place the destination in a defensible position and test it before transporting valuable supplies. Keep a record of your tags so an emergency rename does not strand another player.

Version & sources

Sources & what may change

Linked references
Applies to
Live 0.221.12 through Ashlands; check world settings and mods.
Last verified
September 4, 2026
When to check again
Recheck after the September 9 release, a relevant patch, or a change to the linked documentation. This page is not yet verified for 1.0.