Minecraft portal frame tool

Nether Portal Size Calculator

Choose a valid Nether portal frame size. See exactly how many obsidian blocks you need, whether corners are included, and where each block goes in the opening and outer frame.

Minimum is 4×5 outer (10 obsidian without corners, 14 with). Maximum is 23×23 outer (84 without corners, 88 with). Frame sizing is the same for Java and Bedrock, so this page does not show an edition toggle.

4×5 to 23×23 Obsidian counts Block blueprint
A Nether portal obsidian frame under construction in a bright jungle

Portal frame builder

4–23 blocks

5–23 blocks

Outer size includes the obsidian edge blocks. Width 4–23, height 5–23.

Corner blocks

Corners never change the opening size. They change the obsidian total by 4.

Presets

Presets change dimensions only. Your corner choice stays selected.

Blueprint · unlit frame
4×5 Nether portal frame blueprint Outer frame 4 wide by 5 tall with a 2×3 opening. 10 obsidian blocks with corners omitted.Outer width 4 blocksOuter height 5 blocks

Opening 2×3 · 10 obsidian

Corners omitted · one standalone frame

  • Obsidian edge
  • Opening, not an item
  • Omitted corner

4 wide × 5 tall, 10 obsidian, corners omitted

Material summary

Minimum size

Obsidian required now

10

10 blocks

Four corner blocks omitted

Without corners

Current

10

Skip all four corner blocks.

With all corners

14

Fill the four corners too.

Outer frame

4 × 5

Opening

2 × 3

Opening blocks

6

Build order

  1. Place the bottom edge, then build both side columns to the chosen outer height.
  2. Close the top edge. Leave the whole opening clear; do not fill it with obsidian.
  3. Use ordinary obsidian on the required edges. Crying obsidian does not replace those blocks.
  4. Light the inside with flint and steel or a fire charge after the frame is complete.

Obsidian budget planner

Corners omitted

Whole blocks from 0 to 10,000. Uses your current corner choice.

The suggestion maximizes opening area within your budget. Ties prefer fewer obsidian blocks, then a squarer opening. It is not “the widest portal” and not the only possible frame.

This plans one new standalone frame. It does not subtract blocks already placed or count shared edges between multiple portals.

Best opening area with 64 obsidian: 18×18 outer, 256 opening blocks.

Best feasible frame

18 × 18 outer

Opening: 16×16(256 blocks)

Required: 64(1 stack)

Leftover: 0(0 blocks)

Corner mode: omitted

The maximum vanilla outer frame is 23×23, so surplus obsidian beyond its cost cannot make a larger portal.

Other useful sizes

Steps

How to Use the Nether Portal Size Calculator

  1. Choose Outer frame or Inner opening. The same portal is shown either way, but outer dimensions include the obsidian edge while the opening is the clear space inside.
  2. Enter a whole width and height inside the displayed range. The blueprint updates block by block.
  3. Choose whether to skip or include the four corner blocks. This changes the obsidian total by 4, not the opening size.
  4. Read the required obsidian, opening area, and stack breakdown, then copy the material list or text blueprint if you want it beside the build.

The minimum facts are 4×5 outer with 10 obsidian without corners; the maximum is 23×23 outer with 84 obsidian without corners. Those numbers are calculated from the same frame model used by the tool.

Limits

Minimum and Maximum Nether Portal Dimensions

A standard vertical Nether portal uses an outer frame from 4 to 23 blocks wide and 5 to 23 blocks tall. The opening is always two blocks smaller on each axis, so the smallest opening is 2×3 and the largest is 21×21.

LimitOuter frameOpeningObsidian without cornersObsidian with corners
Minimum4×52×31014
Maximum23×2321×218488

A 5-wide × 4-tall frame is not valid because 4 is below the minimum outer height. The opposite mistake is treating 23×23 as an opening: 23×23 is the outside limit, and a 23×23 clear opening would require a larger frame than vanilla allows.

Modern Java and Bedrock use the same standard frame range. This page does not show an edition toggle because frame sizing does not change between them. Linking behavior and some other portal mechanics can still differ.

Materials

How Much Obsidian Does a Nether Portal Need?

For one standalone rectangular frame, count the perimeter. With W as outer width and H as outer height:

obsidian with corners = 2W + 2H − 4
obsidian without corners = 2W + 2H − 8

The minimum 4×5 frame therefore needs 10 obsidian without corners or 14 with them. The maximum 23×23 frame needs 84 without corners or 88 with them.

At the maximum, 84 blocks is 1 stack + 20 blocks. The complete-corner version, 88 blocks, is 1 stack + 24 blocks. A square 10×10 frame uses 32 without corners and has a 8×8 opening.

These are exact counts for one isolated portal frame. If frames share obsidian edges in a larger build, the amount you place can be lower; this calculator does not claim to optimize shared blocks. Portal interior blocks are not inventory obsidian, so they are reported as opening area instead.

Reference

Nether Portal Size Chart

These useful frame sizes are calculated at page build time from the same formulas as the interactive tool. They are not copied totals from a separate table.

Outer frameOpeningOpening blocksWithout cornersWith corners
4×52×361014
5×63×4121418
6×74×5201822
10×108×8643236
4×232×21424650
23×521×3634852
23×2321×214418488

Build

How to Build and Light the Frame

  1. Place the bottom row of ordinary obsidian to the chosen outer width.
  2. Build both vertical sides up to the chosen outer height, including or skipping the corners.
  3. Close the top row so the required perimeter is complete and the interior is clear.
  4. Light fire inside the finished opening with flint and steel or a fire charge.

Nether portals are upright vertical rectangles, not flat horizontal frames. Placing obsidian alone does not activate the portal; the fire must be inside a complete frame. See the Minecraft Wiki Nether portal reference for the structure rules.

Crying obsidian cannot replace ordinary obsidian on the required functional edges. It appears in ruined portal structures and can be used as unrelated decoration, including optional corner positions, but the working edge needs regular obsidian.

Mistakes

Common Frame Mistakes

  • Confusing the outer frame with the opening, then building a frame two blocks too small.
  • Treating 23×23 as the opening instead of the maximum outside measurement.
  • Trying a 5-wide × 4-tall frame, which fails the minimum height.
  • Leaving a gap in a required edge because “the corner is optional” was applied to the wrong block.
  • Using crying obsidian where the frame needs ordinary obsidian.
  • Digging a flat horizontal frame or building it in the End.
  • Filling the opening with obsidian and expecting it to activate.
  • Assuming a larger frame forces a particular linked destination.

Linking caveat

Does Portal Size Affect Linking?

Frame size does not create a separate set of coordinate rules. The exact portal block you enter can still affect a trip, and a wide frame can present more than one entry position. Do not describe a large frame as purely cosmetic with guaranteed identical linking. See the Minecraft Wiki Nether portal reference for the documented mechanics.

This calculator does not simulate linking. If you already know your portals, use the Nether portal link checker to compare entered portals, edition-specific search areas, Y distance, and the return trip. Its results are representative-point estimates, not guarantees.

FAQ

Nether Portal Size Questions

What is the smallest Nether portal I can build?
The smallest valid outer frame is 4 blocks wide by 5 blocks tall. That leaves a 2×3 opening. It needs 10 obsidian if you skip the four corners, or 14 if you fill them. A 3×4 outer frame is too small.
What is the largest Nether portal in Minecraft?
The largest standard outer frame is 23 blocks wide by 23 blocks tall. Its opening is 21×21, so 23×23 is an outside measurement, not the clear interior. It needs 84 obsidian without corners or 88 with all four corners.
Are the corner obsidian blocks required?
No. The four corners can be left empty or used for decoration. The required top, bottom, and side edge blocks must form a complete rectangular frame. Filling the corners only changes the material count, not the opening size.
Is a 23×23 portal measured inside or outside the frame?
23×23 is the maximum outer frame measurement. The opening inside that frame is 21×21. Likewise, the minimum 4×5 frame has a 2×3 opening. This calculator labels outer and opening dimensions separately so the two are not confused.
Can I make a Nether portal 5 blocks wide and only 4 tall?
No. For a standard vertical rectangular portal, the outer width can be 4 to 23 and the outer height can be 5 to 23. A 5-wide by 4-tall frame is below the minimum height and will not activate.
Does crying obsidian work in the frame?
Crying obsidian cannot replace ordinary obsidian on the required functional edges. It can appear in ruined portal structures and may be used elsewhere as decoration, including optional corners, but the working frame edges need regular obsidian.
Can a large portal link differently than a small portal?
Frame size does not create a separate linking rule, but very wide portals can involve different player entry blocks and destinations in documented game behavior. This calculator does not simulate linking. Use the portal link checker for a representative-point comparison of entered portals.
Is Nether portal frame sizing the same on Java and Bedrock?
Modern Java and Bedrock use the same standard 4×5 to 23×23 outer frame range. Linking and some other portal behavior can differ by edition, but this page does not change frame math by edition because the sizing rules are the same.

Method

How This Calculator Works

The calculator normalizes every input to one outer frame state. Outer width W and height H must be integers from 4–23 and 5–23. Opening mode accepts 2–21 and 3–21, then adds 2 to each axis. The opening area is (W−2)(H−2), and the obsidian formula is 2W + 2H − 4 with corners or 2W + 2H − 8 without them.

The blueprint generates exactly W×H cells. Perimeter cells are obsidian, interior cells are opening, and the four corners are omitted or obsidian depending on your choice. Tests compare every one of the 380 valid width/height combinations against the cell grid, so the diagram and material count cannot silently diverge.

The optional budget planner enumerates all 380 outer frames, keeps those whose required obsidian fits your budget, and ranks by largest opening area, fewer required blocks, a squarer opening, then smaller width and height. It plans one standalone new frame only.

All calculations run in the browser. No portal coordinates are needed, nothing is uploaded, and this page does not store a build. The math is exact for an isolated vanilla-style rectangular frame; terrain, mods, shared multi-portal edges, and the actual linked destination are outside its scope. Read the site calculation methodology for the shared validation and testing approach.

Sources

Minecraft Wiki is a community-maintained reference, not official Mojang documentation. No in-game Java or Bedrock test was performed for this page; the geometry is verified by automated tests against the documented rules above.

Next steps

Plan Where the Portal Goes

Calculate where to build your Nether portal with the homepage coordinate converter, then check which existing portal may connect if you already have a portal network.

Connecting two builds? Plan travel between two portal locations with a two-point Nether route, axis directions, and material estimates.