Version: 2021.1
Texture Import Settings
Texture compression formats

Texture types

You can import different TextureAn image used when rendering a GameObject, Sprite, or UI element. Textures are often applied to the surface of a mesh to give it visual detail. More info
See in Glossary
types into the Unity Editor via the Texture Importer.

Below are the properties available to configure the various Texture types in Unity in the Texture InspectorA Unity window that displays information about the currently selected GameObject, asset or project settings, allowing you to inspect and edit the values. More info
See in Glossary
window. Scroll down or select from the list below to find details of the Texture type you wish to learn about.

Default

Default is the most common Texture type used for all Textures. It provides access to most of the properties for Texture importing. With this Texture type, you can also change the Texture Shape property to define the Texture Shape.

Settings for the Default Texture Type
Settings for the Default Texture Type

When you choose the Default Texture type, the following properties are available (click the links for detailed information on each property):

Property: Function:
sRGB (Color Texture) Enable this property to specify that the Texture is stored in gamma space. More info.
Alpha Source Specify how the alpha channel of the Texture is generated. More info.
Alpha is Transparency Enable this property to dilate the color and avoid filtering artifacts on the edges if the alpha channel you specify is Transparency. More info.
Remove Matte (PSD) Enable special processing for Photoshop files that use transparency (blending color pixels with white). More info
Ignore PNG file gamma Enable this property to ignore the Gamma attribute in PNG files. More info.
Non Power of 2 If the Texture has a non-power of two (NPOT) dimension size, this defines a scaling behavior at import time. More info.
Read/Write Enabled Enable this to access the Texture data from scriptsA piece of code that allows you to create your own Components, trigger game events, modify Component properties over time and respond to user input in any way you like. More info
See in Glossary
using Texture2D.SetPixels, Texture2D.GetPixels and other Texture2D methods. More info.
Virtual Texture Only Enable this texture to use it solely in combination with a Texture Stack for Virtual Texturing. More info.
Streaming Mip Maps Enable this checkbox to use Mip Map Streaming on this Texture. More info.
Generate Mip Maps Check this box to enable mipmap generation. More info.

This property is enabled by default.
Wrap Mode Select how the Texture behaves when tiled. More info.
Filter Mode Select how the Texture is filtered when it gets stretched by 3D transformations. More info.
Aniso Level Increases Texture quality when viewing the Texture at a steep angle. More info.

In addition, you can use the Platform-specific overrides panel to set default options and their overrides for a specific platforms.

Normal map

Select Normal mapA type of Bump Map texture that allows you to add surface detail such as bumps, grooves, and scratches to a model which catch the light as if they are represented by real geometry.
See in Glossary
to turn the color channels into a format suitable for real-time normal mapping. With this Texture type, you can also change the Texture Shape property to define the Texture Shape.

Settings for the Normal map Texture Type
Settings for the Normal map Texture Type

When you choose the Normal map Texture type, you can set the following additional properties:

Property: Function:
Create from Grayscale Enable this property to create the Normal Map from a grayscale heightmapA greyscale Texture that stores height data for an object. Each pixel stores the height difference perpendicular to the face that pixel represents.
See in Glossary
. When enabled, the Bumpiness and Filtering options become available. This option is disabled by default.
Bumpiness Control the amount of bumpiness. A low bumpiness value means that even sharp contrast in the heightmap is translated to gentle angles and bumps. A high value creates exaggerated bumps and very high-contrast lighting responses to the bumps. This option is only visible if Create from Grayscale is checked.
Filtering Determine how the bumpiness is calculated:

- Smooth generates Normal Maps with standard (forward differences) algorithms.
- Sharp generates Normal Maps that are sharper than Standard. This is also known as a Sobel filter.
Ignore PNG file gamma Enable this property to ignore the Gamma attribute in PNG files. More info.
Non Power of 2 If the Texture has a non-power of two (NPOT) dimension size, this defines a scaling behavior at import time. More info.
Read/Write Enabled Enable this to access the Texture data from scripts using Texture2D.SetPixels, Texture2D.GetPixels and other Texture2D methods. More info.
Virtual Texture Only Enable this texture to use it solely in combination with a Texture Stack for Virtual Texturing. More info.
Streaming Mip Maps Enable this checkbox to use Mip Map Streaming on this Texture. More info.
Generate Mip Maps Check this box to enable mipmap generation. More info.

This property is enabled by default.
Wrap Mode Select how the Texture behaves when tiled. More info.
Filter Mode Select how the Texture is filtered when it gets stretched by 3D transformations. More info.
Aniso Level Increases Texture quality when viewing the Texture at a steep angle. More info.

In addition, you can use the Platform-specific overrides panel to set default options and their overrides for a specific platforms.

Editor GUI and Legacy GUI

Select Editor GUI and Legacy GUI if you are using the Texture on any HUD or GUI controls. With this Texture type, the Texture Shape property is always set to 2D for this Texture Type. For more information, see the documentation on Texture Shapes.

Settings for the Editor GUI and Legacy GUI Texture Type
Settings for the Editor GUI and Legacy GUI Texture Type

When you choose the Editor GUI and Legacy GUI Texture type, you can set the following additional properties:

Property: Function:
Alpha Source Specify how the alpha channel of the Texture is generated. More info.
Alpha is Transparency Enable this property to dilate the color and avoid filtering artifacts on the edges if the alpha channel you specify is Transparency. More info.
Remove Matte (PSD) Enable special processing for Photoshop files that use transparency (blending color pixels with white). More info
Ignore PNG file gamma Enable this property to ignore the Gamma attribute in PNG files. More info.
Non Power of 2 If the Texture has a non-power of two (NPOT) dimension size, this defines a scaling behavior at import time. More info.
Read/Write Enabled Enable this to access the Texture data from scripts using Texture2D.SetPixels, Texture2D.GetPixels and other Texture2D methods. More info.
Generate Mip Maps Check this box to enable mipmap generation. More info.

This property is disabled by default.
Wrap Mode Select how the Texture behaves when tiled. More info.
Filter Mode Select how the Texture is filtered when it gets stretched by 3D transformations. More info.
Aniso Level Increases Texture quality when viewing the Texture at a steep angle. More info.

In addition, you can use the Platform-specific overrides panel to set default options and their overrides for a specific platforms.

Sprite (2D and UI)

Select Sprite (2D and UI) if you are using the Texture in a 2D game as a SpriteA 2D graphic objects. If you are used to working in 3D, Sprites are essentially just standard textures but there are special techniques for combining and managing sprite textures for efficiency and convenience during development. More info
See in Glossary
. With this Texture type, the Texture Shape property is always set to 2D for this Texture Type. For more information, see the documentation on Texture Shapes.

Settings for the Sprite (2D and UI) Texture Type
Settings for the Sprite (2D and UI) Texture Type

When you choose the Sprite (2D and UI) Texture type, you can set the following additional properties:

Property: Function:
Sprite Mode Specify how to extract the Sprite graphic from the image. The default for this option is Single.
Single Use the Sprite image as is. You can clip and edit the image in the Sprite Editor to refine it further, but Unity treats the Sprite generated from the imported Texture as a single Asset.
Multiple Choose this value if your image has several elements in the same image. You can then define the location of the elements in the Sprite Editor so that Unity knows how to split the image into different sub-Assets. For example, you can create animation frames from a single sheet with multiple poses, create TilesA simple class that allows a sprite to be rendered on a Tilemap. More info
See in Glossary
from a single Tilesheet, or create the different parts of a character.
Polygon Choose this value to clip the Sprite Texture according to the MeshThe main graphics primitive of Unity. Meshes make up a large part of your 3D worlds. Unity supports triangulated or Quadrangulated polygon meshes. Nurbs, Nurms, Subdiv surfaces must be converted to polygons. More info
See in Glossary
defined in the Sprite Editor’s Sprite Custom Outline.
Packing Tag Specify (by name) the Sprite AtlasA texture that is composed of several smaller textures. Also referred to as a texture atlas, image sprite, sprite sheet or packed texture. More info
See in Glossary
which you want to pack this Texture into. This property is visible only when you enable the Legacy Sprite Packer in your Project.
Pixels Per Unit The number of pixelsThe smallest unit in a computer image. Pixel size depends on your screen resolution. Pixel lighting is calculated at every screen pixel. More info
See in Glossary
of width/height in the Sprite image that correspond to one distance unit in world space.
Mesh Type Define the Mesh type for the Sprite you want Unity to generate. The default for this option is Tight.

Note: This property is only available for the Single and Multiple Sprite Modes.
Full Rect Choose this value to create a quadA primitive object that resembles a plane but its edges are only one unit long, it uses only 4 vertices, and the surface is oriented in the XY plane of the local coordinate space. More info
See in Glossary
(four-sided polygon) to map the Sprite onto.
Tight Choose this value to generate a Mesh based on pixel alpha value. The Mesh that Unity generates generally follows the shape of the Sprite.

Note: Any Sprite that is smaller than 32x32 uses Full Rect, even when Tight is specified.
Extrude EdgesA Texture property that enables you to define how much area to leave around a sprite in a generated mesh.
See in Glossary
Use the slider to determine how much area to leave around the Sprite in the generated Mesh.
Pivot The location in the image where the Sprite’s local coordinate system originates. Choose one of the pre-set options, or select Custom to set your own Pivot location in X and Y.

Note: This property is only available for the Single Sprite Mode.
Generate Physics Shape When this is enabled and you have not defined a Custom Physics Shape for this Sprite, Unity generates a default Physics Shape from the outline of the Sprite.

Note: This property is only available for the Single and Multiple Sprite Modes.
Sprite Editor Click this button to define how you want Unity to separate the elements on an image with Multiple elements (to create sub-Assets) or refine the shape, size, and pivot position of a Polygon shape.

Note: You need to install the 2D Sprite package in order to use the Sprite Editor. For information about how to find and install packages in the Unity Package Manager, see Finding packages and Installing from the registry.
sRGB (Color Texture) Enable this property to specify that the Texture is stored in gamma space. More info.
Alpha Source Specify how the alpha channel of the Texture is generated. More info.
Alpha is Transparency Enable this property to dilate the color and avoid filtering artifacts on the edges if the alpha channel you specify is Transparency. More info.
Remove Matte (PSD) Enable special processing for Photoshop files that use transparency (blending color pixels with white). More info
Ignore PNG file gamma Enable this property to ignore the Gamma attribute in PNG files. More info.
Read/Write Enabled Enable this to access the Texture data from scripts using Texture2D.SetPixels, Texture2D.GetPixels and other Texture2D methods. More info.
Generate Mip Maps Check this box to enable mipmap generation. More info.

This property is disabled by default.
Wrap Mode Select how the Texture behaves when tiled. More info.
Filter Mode Select how the Texture is filtered when it gets stretched by 3D transformations. More info.
Aniso Level Increases Texture quality when viewing the Texture at a steep angle. More info.

In addition, you can use the Platform-specific overrides panel to set default options and their overrides for a specific platforms.

Cursor

Select Cursor to use the Texture as a custom cursor. With this Texture type, the Texture Shape property is always set to 2D for this Texture Type. For more information, see the documentation on Texture Shapes.

Settings for the Cursor Texture Type
Settings for the Cursor Texture Type

When you choose the Cursor Texture type, you can set the following additional properties:

Property: Function:
Alpha Source Specify how the alpha channel of the Texture is generated. More info.
Alpha is Transparency Enable this property to dilate the color and avoid filtering artifacts on the edges if the alpha channel you specify is Transparency. More info.
Remove Matte (PSD) Enable special processing for Photoshop files that use transparency (blending color pixels with white). More info
Ignore PNG file gamma Enable this property to ignore the Gamma attribute in PNG files. More info.
Non Power of 2 If the Texture has a non-power of two (NPOT) dimension size, this defines a scaling behavior at import time. More info.
Read/Write Enabled Enable this to access the Texture data from scripts using Texture2D.SetPixels, Texture2D.GetPixels and other Texture2D methods. More info.
Generate Mip Maps Check this box to enable mipmap generation. More info.

This property is disabled by default.
Wrap Mode Select how the Texture behaves when tiled. More info.
Filter Mode Select how the Texture is filtered when it gets stretched by 3D transformations. More info.
Aniso Level Increases Texture quality when viewing the Texture at a steep angle. More info.

In addition, you can use the Platform-specific overrides panel to set default options and their overrides for a specific platforms.

Cookie

Select Cookie to set your Texture up with the basic parameters used for cookies in the Built-in Render PipelineA series of operations that take the contents of a Scene, and displays them on a screen. Unity lets you choose from pre-built render pipelines, or write your own. More info
See in Glossary
. With this Texture type, Unity updates the Texture Shapes property automatically based on the selected Light Type:

  • Directional and Spotlight cookies are always 2D Textures (the 2D shape type).
  • Point Light cookies must be cubemapsA collection of six square textures that can represent the reflections in an environment or the skybox drawn behind your geometry. The six squares form the faces of an imaginary cube that surrounds an object; each face represents the view along the directions of the world axes (up, down, left, right, forward and back). More info
    See in Glossary
    (the Cube shape type).
Settings for the Cookie Texture Type
Settings for the Cookie Texture Type

When you choose the Cookie Texture type, you can set the following additional properties:

Property: Function:
Light Type Define the type of Light that the cookie is applied to.

Note that you must create your source texture with an appropriate layout: cookies for Point Lights must be laid out as cubemaps, and cookies for Directional Lights and Spot Lights must be laid out as regular 2D Textures.

If you apply a cookie to a Directional Light, you can use a cookie configured for a Directional Light, or a cookie configured for a Spot Light. A Directional Light using a cookie configured for a Directional Light repeats the cookie in a tiled pattern all over the scene. A Directional Light using a cookie configured for a Spot Light projects the cookie just once in the direct path of the “beam” of the light. This is the only case where the position of a Directional Light is important.
Spotlight With this type of Light, you want the edges of your Cookie Texture to be solid black to get the proper effect, so Unity sets the Wrap Mode to Clamp by default.
Directional With this type of Light, this Texture tiles, so Unity sets the Wrap Mode to Repeat by default.
Point When you choose this type of Light, you can also customize the Cube shape-specific
Alpha Source Specify how the alpha channel of the Texture is generated. More info.
Alpha is Transparency Enable this property to dilate the color and avoid filtering artifacts on the edges if the alpha channel you specify is Transparency. More info.
Remove Matte (PSD) Enable special processing for Photoshop files that use transparency (blending color pixels with white). More info
Ignore PNG file gamma Enable this property to ignore the Gamma attribute in PNG files. More info.
Non Power of 2 If the Texture has a non-power of two (NPOT) dimension size, this defines a scaling behavior at import time. More info.
Read/Write Enabled Enable this to access the Texture data from scripts using Texture2D.SetPixels, Texture2D.GetPixels and other Texture2D methods. More info.
Generate Mip Maps Check this box to enable mipmap generation. More info.

This property does not change when switching to the Cookie Texture type.
Wrap Mode Select how the Texture behaves when tiled. More info.
Filter Mode Select how the Texture is filtered when it gets stretched by 3D transformations. More info.
Aniso Level Increases Texture quality when viewing the Texture at a steep angle. More info.

In addition, you can use the Platform-specific overrides panel to set default options and their overrides for a specific platforms.

Lightmap

Select LightmapA pre-rendered texture that contains the effects of light sources on static objects in the scene. Lightmaps are overlaid on top of scene geometry to create the effect of lighting. More info
See in Glossary
if you are using the Texture as a Lightmap. This option enables encoding into a specific format (RGBM or dLDR, depending on the platform) and a post-processingA process that improves product visuals by applying filters and effects before the image appears on screen. You can use post-processing effects to simulate physical camera and film properties, for example Bloom and Depth of Field. More info post processing, postprocessing, postprocess
See in Glossary
step on Texture data (a push-pull dilation pass). With this Texture type, the Texture Shape property is always set to 2D for this Texture Type. For more information, see the documentation on Texture Shapes.

Settings for the Lightmap Texture Type
Settings for the Lightmap Texture Type

When you choose the Lightmap Texture type, you can set the following additional properties:

Property: Function:
Ignore PNG file gamma Enable this property to ignore the Gamma attribute in PNG files. More info.
Non Power of 2 If the Texture has a non-power of two (NPOT) dimension size, this defines a scaling behavior at import time. More info.
Read/Write Enabled Enable this to access the Texture data from scripts using Texture2D.SetPixels, Texture2D.GetPixels and other Texture2D methods. More info.
Streaming Mip Maps Enable this checkbox to use Mip Map Streaming on this Texture. More info.
Generate Mip Maps Check this box to enable mipmap generation. More info.

This property does not change when switching to the Lightmap Texture type.
Wrap Mode Select how the Texture behaves when tiled. More info.
Filter Mode Select how the Texture is filtered when it gets stretched by 3D transformations. More info.
Aniso Level Increases Texture quality when viewing the Texture at a steep angle. More info.

In addition, you can use the Platform-specific overrides panel to set default options and their overrides for a specific platforms.

Single Channel

Select Single Channel if you only need one channel in the Texture. With this Texture type, you can also change the Texture Shape property to define the Texture Shape.

Settings for the Single Channel Texture Type
Settings for the Single Channel Texture Type

When you choose the Single Channel Texture type, you can set the following additional properties:

Property: Function:
Channel Specify whether you want Unity to treat the Texture as an Alpha or Red channel.
Alpha Use the alpha channel. This setting does not allow compressionA method of storing data that reduces the amount of storage space it requires. See Texture Compression, Animation Compression, Audio Compression, Build Compression.
See in Glossary
.
Red Use the red color component.
Alpha Source Specify how the alpha channel of the Texture is generated. More info.
Alpha is Transparency Enable this property to dilate the color and avoid filtering artifacts on the edges if the alpha channel you specify is Transparency. More info.
Remove Matte (PSD) Enable special processing for Photoshop files that use transparency (blending color pixels with white). More info
Ignore PNG file gamma Enable this property to ignore the Gamma attribute in PNG files. More info.
Non Power of 2 If the Texture has a non-power of two (NPOT) dimension size, this defines a scaling behavior at import time. More info.
Read/Write Enabled Enable this to access the Texture data from scripts using Texture2D.SetPixels, Texture2D.GetPixels and other Texture2D methods. More info.
Streaming Mip Maps Enable this checkbox to use Mip Map Streaming on this Texture. More info.
Generate Mip Maps Check this box to enable mipmap generation. More info.

This property does not change when switching to the Single Channel Texture type.
Wrap Mode Select how the Texture behaves when tiled. More info.
Filter Mode Select how the Texture is filtered when it gets stretched by 3D transformations. More info.
Aniso Level Increases Texture quality when viewing the Texture at a steep angle. More info.

In addition, you can use the Platform-specific overrides panel to set default options and their overrides for a specific platforms.

Texture Import Settings
Texture compression formats