docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    UV Editor window

    Use the UV Editor window to manage texture mapping on the selected Mesh.

    To open this window, go to Main Menu > Tools > ProBuilder > Editors > Open UV Editor.

    UV Editor window

    (A) The UV Editor toolbar contains general features for working with UVs.

    (B) The UV drop-down menu allows you to switch between UV channels:

    • Choose UV to edit the UV mapping for shaders.
    • Choose UV2 (read-only) to regenerate your baked or realtime lightmaps.

    (C) The Actions panel is a dynamic panel:

    • What kind of UVs you are editing (shader UVs or lightmap UV2s) determine which set of options appear in the panel.
    • For shader UV options, you can switch between using manual UV editing or auto-texturing, and these each have their own specific options as well. For more information, see UV editing modes.
    • Only actions compatible with the selected UV element type (vertex, edge, face) are available. If you are in object selection mode when you open the UV Editor, all options are disabled: you must select one or more faces, edges, or vertices to continue.

    (D) You can use the UV viewer to view and edit the selected object's UV elements directly.

    Tip: While working in the UV viewer's work area (canvas), sometimes the Texture becomes only partially visible (for example, if you zoomed in so you could see more detail on the Texture). To quickly re-center the Texture, use the 0 shortcut. You can also re-map this shortcut with the Shortcuts Manager.

    UV editing modes

    The UV Editor supports two modes when you edit texture mapping:

    • Automatic : ProBuilder manages the texture mapping according to the settings in the Actions panel automatically, even when you resize the Mesh. This is the default. Use this mode for simple texturing work, especially architectural or hard-surface items. Tiling, Offset, Rotation, and other controls are available, while ProBuilder automatically manages the projection and updates it as you modify the Mesh geometry.

      For example, use automatic tiling to for a brick texture on a wall. This maintains the size and orientation of the brick even if you resize the wall. Textures like brick with a repeating pattern are ideal for automatic mode.

    • Manual : Use the UV Editor to precisely unwrap and edit UVs, render UV Templates, project UVs, and more. To modify the texture mapping, you move, rotate, and resize the UV elements against the Texture in the viewer. ProBuilder provides two texture projection methods (Box and Planar), along with several helpers in the Actions panel to help you select and edit elements.

      For example, you can use a texture image for an element with details like a building where some areas contain windows or doors. Using the Manual mode in these cases is ideal, because you can position the UV elements precisely against the image.

    Each face supports only one mode at a time, but you can use a mixture of the two modes on the same Mesh. This is especially useful when some parts of a Model need to have tiling Textures, while others are unwrapped. If you select several faces at once, and some are in Automatic mode and others are in Manual, the Actions panel displays both buttons: Convert to Manual and Convert to Auto.

    Actions panel when some selected faces are in Automatic editing mode and some are Manual


    Did you find this page useful? Please give it a rating:

    Thanks for rating this page!

    Report a problem on this page

    What kind of problem would you like to report?

    • This page needs code samples
    • Code samples do not work
    • Information is missing
    • Information is incorrect
    • Information is unclear or confusing
    • There is a spelling/grammar error on this page
    • Something else

    Thanks for letting us know! This page has been marked for review based on your feedback.

    If you have time, you can provide more information to help us fix the problem faster.

    Provide more information

    You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:

    You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:

    You've told us there is information missing from this page. Please tell us more about what's missing:

    You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:

    You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:

    You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:

    You've told us this page has a problem. Please tell us more about what's wrong:

    Thank you for helping to make the Unity documentation better!

    Your feedback has been submitted as a ticket for our documentation team to review.

    We are not able to reply to every ticket submitted.

    In This Article
    • UV editing modes
    Back to top
    Copyright © 2025 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)