Replace ProGrids with Unity 2022.3 Grid Snapping

ProGrids appears in many older Unity level-design tutorials, but it is a legacy preview package documented for Unity 2020.x. For a new Unity 2022.3 project, use the snapping tools built into the Scene view instead of adding com.unity.progrids.

Quick start

Set the snap increments once, align the first piece, and then duplicate on the grid.

  1. Open the Grid and Snap overlay in the Scene view.
  2. Set the Move, Rotate, and Scale values under Increment Snap.
  3. Use automatic grid snapping or hold Ctrl while moving, rotating, or scaling.
VRChat project note

Unity's built-in snapping is an Editor workflow, so it does not add a ProGrids package dependency to the VRChat project. Keep new Creator Companion projects on the Unity version selected by VRChat.

ProGrids Status

Tool Where it belongs Recommendation
ProGrids com.unity.progrids@3.0 Older Unity projects and tutorials Treat it as a legacy preview package.
Unity Grid and Snap overlay Unity 2022.3 Scene view Use it for grid visibility, automatic snapping, alignment, and snap increments.
Unity vertex and surface snapping Unity 2022.3 Move tool Use it when a regular grid does not match the geometry.

Unity's 2022.3 list of released packages does not include ProGrids. Do not use Install package by name to force it into a new project just because an older tutorial opens a ProGrids window.

Find the Grid and Snap Controls

The controls are in an overlay at the top of the Scene view. If the overlay is hidden:

  1. Open the Overlays menu in the Scene view.
  2. Enable Grid and Snap.
  3. Use the grid visibility menu to choose the grid plane and display options.
  4. Use the grid snapping menu for automatic snapping and Align Selected.
  5. Use the snap increment menu to set move, rotation, and scale increments.

Grid and Snap settings apply to every Scene view. Unity also separates the displayed grid size from the increment values: changing the visual grid size does not change the distance used by incremental snapping.

Translate ProGrids Tutorial Steps

An older tutorial says Use in Unity 2022.3
Open the ProGrids window Open the Scene view Grid and Snap overlay.
Turn snapping on Activate automatic grid snapping in the overlay.
Set the snap unit Set Move, Rotate, and Scale under Increment Snap.
Push the selection to the grid Use Align Selected, or press Ctrl+\ on Windows and Command+\ on macOS for all axes.
Snap temporarily while dragging Hold Ctrl on Windows or Command on macOS while using a transform gizmo.
Snap one mesh corner to another Activate the Move tool, hold V, select the source vertex, and drag it to the target vertex.

Automatic grid snapping requires the Move tool and a Global handle orientation. It snaps along the active gizmo axis.

Configure Snap Increments

Open the snap increment menu in the Grid and Snap overlay, then set:

  • Move: a uniform value for all axes, or unlink the axes and enter separate X, Y, and Z values.
  • Rotate: an angle in degrees.
  • Scale: a scale factor.

Choose move increments that match the dimensions of the modular kit you are placing. If a wall is designed around a particular unit length, use that measured length or an exact divisor of it instead of guessing from the Scene view.

Align a Modular Kit

  1. Inspect the dimensions and pivot position of the floor, wall, or ceiling prefab.
  2. Enter a matching Move increment.
  3. Select the first piece and use Align Selected on the required axes.
  4. Duplicate the aligned piece.
  5. Move the duplicate with automatic snapping, or hold Ctrl while dragging a gizmo handle.
  6. Check the Transform values and the seam before repeating the piece across the room.

Snapping moves a pivot by exact increments; it does not correct a misplaced pivot or mismatched mesh dimensions. If pieces still leave gaps, compare their pivots, bounds, scale, and source dimensions.

Vertex and Surface Snapping

Use vertex snapping when two pieces must meet at their actual mesh geometry rather than at a regular grid interval:

  1. Select the mesh and activate the Move tool.
  2. Hold V.
  3. Move the pointer over the vertex that should act as the source point.
  4. Drag that vertex onto a vertex of another mesh.
  5. Release the mouse button and then V.

Unity also supports surface snapping to a collider: with the Move tool active, hold Shift+Ctrl on Windows or Shift+Command on macOS while dragging a tool handle onto the target collider.

Legacy Projects That Already Use ProGrids

Do not upgrade a working legacy project solely to replace its ProGrids interface. First:

  1. Record the Unity and ProGrids versions used by the project.
  2. Make a separate backup or migration copy.
  3. Record the grid and snap values used by the scene.
  4. Reproduce those values with Unity's built-in tools in the target editor.
  5. Confirm that the modular pieces still align before changing package dependencies.

The legacy ProGrids manual remains useful for identifying what an old tutorial is doing. It is not an installation recommendation for Unity 2022.3.

Legacy Video Reference

The video below demonstrates the older ProGrids interface. Use the translation table above when following it in Unity 2022.3.

Troubleshooting

The Grid and Snap overlay is missing

Open the Scene view Overlays menu and enable Grid and Snap. The controls moved into the overlay toolbar in Unity 2021.2.

Objects snap by the wrong distance

Open the snap increment menu and check the Move values. The visual grid size and the incremental snap values are separate settings.

Align Selected moves an object on the wrong axis

Use the individual X, Y, or Z buttons under Align Selected. The Ctrl+\ or Command+\ shortcut aligns all axes at once.

Modular pieces still have gaps after snapping

Compare the pieces' pivots, dimensions, Transform scale, and mesh bounds. Snapping places pivots precisely, but it cannot make differently sized geometry fit together.

An older tutorial says to install ProGrids

Translate its actions with the table on this page. Unity 2022.3 already includes grid, incremental, surface, and vertex snapping, and its released-package list does not include ProGrids.

A legacy project already contains ProGrids

Keep the original project on its compatible Unity version until you have a backed-up migration copy. Record the snap values, reproduce the placement with built-in tools, and verify the scene before changing package dependencies.

Continue Learning

Official References

Related Navigation