docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Changelog

    [17.0.1] - 2026-11-17

    Changed

    • The PSD Importer no longer writes to the .meta file of a .psb or .psd file while importing it. The layers it pairs Sprite IDs with are recorded when you apply changes in the Inspector or the Sprite Editor.
    • In Individual Sprites (Mosaic) mode, applying any change to a .psb or .psd file removes the Sprite rects and names edited in an earlier version from its .meta file, which the importer no longer uses, and stops the warning about them.
    • In Individual Sprites (Mosaic) mode, ISpriteEditorDataProvider.SetSpriteRects takes only the alignment, pivot and border of existing Sprites. It ignores name and rect changes and added rects, which the importer generates from the layers.
    • PSD Importer Presets no longer save or apply data that belongs to the source file, such as Sprite rects, layers, rig data and Sprite Library categories.
    • Applying changes to a .psb or .psd file imported by an early PSD Importer version moves the identifiers of its texture, prefab, Sprite Library Asset and skeleton asset into the internal ID table of its .meta file. The IDs of the imported objects do not change.

    Fixed

    • Reimporting a .psb or .psd file could log that the importer generated an inconsistent result, because the import depended on the previous import.
    • Setting PSDImporter.mipmapFadeDistanceStart no longer overwrites PSDImporter.mipmapFadeDistanceEnd. (UUM-161204)
    • Applying in the Skinning Editor no longer drops the bones of Sprites whose layers are hidden or unchecked. (UUM-161627)

    [17.0.0] - 2026-11-06

    Added

    • PSDImporter.mosaicPadding, which replaces the misspelled PSDImporter.mosiacPadding. (D2D-8325)

    Deprecated

    • PSDImporter.mosiacPadding is deprecated and will be removed in a future release. Use PSDImporter.mosaicPadding instead. The API Updater offers to rewrite existing scripts automatically. (D2D-8325)

    Fixed

    • Fixed compiler warnings CS0414 and CS8524 in PSDImporter.cs being logged to the Console when creating a project from the Universal 2D template. (UUM-154768)
    • Fixed an error being logged to the Console when applying PSD Importer settings in the Inspector while the Sprite Editor has unapplied changes for the same asset. (UUM-154708)

    Changed

    • Move string to hashcode to common package.
    • Pin hosted package documentation links to com.unity.2d.psdimporter@17.0 and align Unity Manual and Script Reference links to Unity 7000.0.
    • The PSD Importer no longer stores a Sprite ID in each layer import setting. The spriteId entries under pSDLayerImportSetting are removed from the .meta file the next time it is written.
    • The "Keep Duplicate Names" setting is now saved in .psd/.psb .meta files as keepDuplicateSpriteName instead of the misspelled keepDupilcateSpriteName. Existing values are read from the old key. (D2D-8420)

    Removed

    • Removed the sprite and layer data fields deprecated in 9.0.0, and their automatic migration. Open projects last saved in Unity 2022.3 in Unity 6000.x before you upgrade. (D2D-8379)
    • Removed the Automatic Reslice option. In Individual Sprites (Mosaic) mode, the PSD Importer now always generates Sprite rects and names from the layers of the source file, and discards rects and names that were edited while the option was disabled. (D2D-8424)

    [16.0.0] - 2026-09-02

    Changed

    • Internal refactor to isolate code that does meta writing.

    Fixed

    • Fix Custom Outline and Custom Physics Outline not being saved when Sprite Mode is set to Single or Polygon. (UUM-150014)
    • Fixed layers with duplicated names losing their Sprite ID and Sprite rect when Layer Mapping is set to Use Layer Name. (UUM-150011)

    [15.0.0] - 2026-05-19

    Fixed

    • Package Manager Samples section title now displays "PSD Importer" consistently. (UUM-135396)

    Changed

    • Pin hosted package documentation links to com.unity.2d.psdimporter@15.0 and align Unity Manual and Script Reference links to Unity 6000.6.

    [14.0.2] - 2026-02-17

    [14.0.1] - 2026-02-10

    Changed

    • Remove automatically added tangents from vertex attributes of sprites with bones.

    [14.0.0] - 2026-01-20

    Changed

    • Update Unity min version for package.

    [13.0.1] - 2025-10-30

    Fixed

    • Fix null reference exception occurs when importing psd without visible layers. (DANB-1155)
    • Correct layer mask position relative to its layer. (DANB-1177)

    [13.0.0] - 2025-09-30

    Changed

    • Update Unity min version for package.
    • Exclude empty layers from import.

    [12.0.0] - 2025-07-17

    Changed

    • Update minimum Unity version.
    • Highlight a PSD file when clicking the console log about layer ID duplication.

    [11.0.1] - 2025-06-04

    Fixed

    • Replaced deprecated non-generic IMGUI TreeViewItem. (Case DANB-1004)
    • Fixed case Layer Separation toggle icon is invisible when the icon state is "separated" with mousedown. (Case DANB-949)

    [11.0.0] - 2025-05-07

    Changed

    • Update minimum Unity version.

    Fixed

    • Fixed case Layer Separation toggle icon is invisible when the icon state is "separated" with mousedown. (Case DANB-949)
    • Fixed case Layer Merging and Separation toggle icon is obscured in the Layer Management Panel of the PSD Importer (Case DANB-889)
    • Fixed case the Include Hidden Layers option in the PSD Importer's Layer Management Panel is not being toggled reliably (Case DANB-888)
    • Fixed a typo in settings. (Case DANB-891)
    • Fixed case where "Mip Map Preserve Coverage" is cut off in the Inspector window. (Case DANB-892)
    • doc: fix headings and incorrect links in the PSDImporter properties page

    [10.1.0] - 2025-03-07

    Fixed

    • DANB-848 Fixed case where scroll down problems occur and the "Apply" button cannot be pressed when the "Advanced" tab is expanded
    • Properly expose Tilemap related APIs in the PSDImporter.

    [10.0.0] - 2024-12-09

    Added

    • Added support for Sprite Frame Editing capabilities where data that are from the source file are locked by default.
    • Added new ability to generate Tile asset and Tile Palette from PSDImporter.

    [9.0.3] - 2024-04-01

    Fixed

    • Fix source file cannot be deleted after subsequent import. (Case DANB-579)

    Changed

    • Updated the Editor Analytics to use the latest APIs.

    [9.0.2] - 2024-02-06

    Fixed

    • Provide custom packing override for users to override to address DANB-526. (Case DANB-526)
    • Fixed layers are not shown in LayerImportSettings after unselecting all layers and applying. (Case DANB-569)

    [9.0.1] - 2023-08-15

    Fixed

    • Fixed case where PSDImporter does not support the PVRTC compression format for the iOS platform. (Case DANB-500)
    • Provide custom packing override for users to override to address DANB-526. (Case DANB-526)

    [9.0.0] - 2023-02-23

    Fixed

    • Fixed an issue where warning logs in the console would get cut short due to invalid characters in layer names.

    [9.0.0-pre.2] - 2022-11-30

    Fixed

    • Enabled the ability to select mipmap streaming for textures imported with the PSD Importer.
    • Fixed an issue where the amount of alpha removed from layers would not be re-applied as final position offset of the layers.
    • Fixed an issue where the editor would crash when importing .psd/.psb files with their layers outside of the document canvas. (Case DANB-300)
    • Fixed an issue where the generated GameObjects would be laid out differently from how they appear in the DCC tool. (Case DANB-298)

    [9.0.0-pre.1] - 2022-09-21

    Changed

    • Simplified the Sprite Meta Data storage. We now have 3 storages; Single Sprite, Multiple Sprites and Mosaiac (Atlased) Sprites.
    • Simplified the Psd Layer storage. We now only have one storage, Psd Layers.
    • PSD Importer no longer depends on 2D Animation.

    Fixed

    • Improved import speed and memory allocation for psd/psb files by reducing the intermediate texture buffers.
    • Fixed exception when showing PSDImporter inspector. (Case DANB-195)
    • Fixed a case where a .psd/.psb would not import with the correct layer coordinates.

    [8.0.0-pre.3] - 2022-05-31

    Changed

    • Update dependency package version.

    [8.0.0-pre.2] - 2022-05-20

    Fixed

    • Fixed Sprite missing reference on certain source file created by third party tools. (Case DANB-30)

    [8.0.0-pre.1] - 2022-03-21

    Fixed

    • Allow multi editing for PSDImporter Settings tab. (Case 1400534)
    • Fixed import not importing when Apply is clicked on Inspector.

    Changed

    • SpriteSkins generated by the PSD Importer now have their rootBone assigned to the root object of the model prefab.

    Added

    • Added drop down list utility in Layer Management tool for quick selection of layers for import.

    [7.0.0] - 2022-01-25

    Changed

    • Package release version.

    Fixed

    • Fixed null exception when importing files with masks. (Case 1388820)

    [7.0.0-pre.4] - 2021-11-24

    Fixed

    • Fixed per platform settings does not get applied in Windows platform. (Case 1376608)
    • Fixed unable to change mipmap settings in inspector. (Case 1379426)
    • Fixed PSDImporter to able to specify swizzle data.

    Added

    • Added ability to change swizzle format in inspector.

    [7.0.0-pre.3] - 2021-10-21

    Changed

    • Update to latest com.unity.2d.animation package

    [7.0.0-pre.2] - 2021-10-11

    Fixed

    • Fixed artifacts on images when flatten
    • Fixed exception "PsdInvalidException: Unrecognized layer section type" when importing certain files.

    [7.0.0-pre.1] - 2021-08-06

    Changed

    • Update Unity supported version to 2022.1

    Fixed

    • Removed memory requirement check since we cannot properly determine if there will be enough memory to import the file (case 1338690)

    [6.0.0-pre.4] - 2021-07-05

    Fixed

    • Fixed changing PSD Importer inspector fields causes UnityEditor.ObjectPreview errors (case 1333823)
    • Fixed 2D PSDImporter always imports .psb files when switching build platforms (case 1327701)
    • Fixed 2D PSDImporter doesn't apply settings from Sprite Editor Window when changes made in Inspector (case 1339799)

    [6.0.0-pre.3] - 2021-05-17

    Changed

    • Update dependency version

    [6.0.0-pre.2] - 2021-05-14

    Changed

    • Update dependency version

    [6.0.0-pre.1] - 2021-05-05

    Changed

    • Version bump for Unity 2021.2

    Added

    • Add ability to use Photoshop file's layer name to map to SpriteRect instead of using layer id
    • Provide auto custom Physics shape generation option
    • Add support to collapse layers in a Photoshop file's group
    • Improve PSDImporter Inspector

    Fixed

    • Fixed Unity hang when importing certain PSD files (case 1312835)

    [5.0.0] - 2021-03-17

    Changed

    • Update version for release

    [5.0.0-pre.3] - 2021-03-15

    Changed

    • Updated documentation

    [5.0.0-pre.2] - 2021-01-16

    Changed

    • Update license file

    Fixed

    • Fixed case 1291323 where upgrading from PSDImporter v2 causes Sprite to be missing

    [5.0.0-pre.1] - 2020-11-02

    Added

    • Added bone sharing from other PSDImporter file

    [4.0.2] - 2020-08-31

    Fixed

    • Fixed importing files with vector layers generates textures incorrectly (case 1266986)
    • Fixed Sprite Editor Window doesn't show the Sprite when the Inspector is locked and the Sprite is not selected in the Project window

    [4.0.1] - 2020-07-07

    Fixed

    • Fixed ArgumentException thrown when 2D Game Kit is imported for the first time (case 1244287)
    • Updated to use non-experimental AssetImporter (case 1254380)

    [4.0.0] - 2020-05-11

    Changed

    • Version bump for Unity 2020.2

    [3.1.4] - 2020-04-09

    Fixed

    • Fix PSD import issues with PSD file without unique layer id
    • Fix crash on importing huge PSD files
    • Fix metafile not updated when reimporting
    • Fix error when importing PSB files with 32-bit color

    Changed

    • Improve PSD file import performance

    [3.1.3] - 2020-03-20

    Changed

    • Update 2D Animation dependency

    [4.0.0] - 2020-03-11

    Changed

    • Version bump for Unity 2020.2

    [3.1.2] - 2020-02-27

    Fixed

    • Fixed broken documentation links in inspectors
    • Fixed empty GameObjects created in certain cases

    [3.1.1] - 2020-01-09

    Fixed

    • Fix wrong dependency version

    [3.1.0] - 2019-12-16

    Added

    • Expose PSDImporter class to be accessible via scripting
    • Added example in manual to show how to set PSDImporter as default importer for PSD files.

    [3.0.0] - 2019-11-06

    Changed

    • Update version number for Unity 2020.1
    • Update documentation

    [2.0.6] - 2019-10-18

    Fixed

    • Fixed SpriteRect name clash when Photoshop layer is renamed to the same name as an exisiting user created SpriteRect

    [2.0.5] - 2019-08-06

    Fixed

    • Physics Shape not saved into Sprite when importing with AssetDatabase V2

    Added

    • Experimental feature to have Sprites with same name generated from source file
    • Support for providing Layer and Group order to Animation Skinning Module

    [2.0.4] - 2019-08-09

    Added

    • Add related test packages
    • Add support Secondary Texture Module in Sprite Editor Window

    Fixed

    • Texture and SpriteLibraryAsset subassets in PSDImporter now follows the main asset's name.

    [2.0.3] - 2019-07-20

    Changed

    • Update 2D Animation dependency

    [2.0.2] - 2019-07-13

    Changed

    • Mark package to support Unity 2019.3.0a10 onwards.

    [2.0.1] - 2019-06-12

    Changed

    • Update 2D Animation dependency

    [2.0.0] - 2019-06-17

    Changed

    • Remove preview tag
    • Remove experimental namespace

    [1.2.0-preview.2] - 2019-06-07

    Added

    • Change API to internal access
    • Only generate Sprite Library Asset if there is entry
    • Do not reset Reslice checkbox after Inspector apply

    [1.2.0-preview.1] - 2019-03-15

    Added

    • Update support for 2019.2
    • Integrate with 2D Animation Sprite Library
    • Integrate with new 2D Animation Character Group
    • Fix asset name conflict

    [1.1.0-preview.2] - 2019-04-23

    Added

    • Fix potential name clashing issues with ScriptedImporter
    • Fix Prefab asset using wrong name. Note this will break Prefab references if upgrading from previous versions.

    [1.1.0-preview.1] - 2019-02-19

    Added

    • Update dependency for 2019.1 support

    [1.0.0-preview.3] - 2019-02-19

    Added

    • Fix compilation error in .NET 3.5

    [1.0.0-preview.2] - 2019-01-25

    Added

    • Fix unable to rig Sprites created manually
    • Remove legacy packing tag
    • Default Texture Type is changed to 'Sprite (2D and UI)'
    • Default Sprite Mode is changed to 'Multiple'

    [1.0.0-preview.1] - 2018-11-20

    Added

    • New release
    • ScriptedImporter for importing Adobe Photoshop file
    • Supports handling of Adobe Photoshop layers
      • Creates Sprites from individual layers
      • Handles include or exclude hidden layers
    • Supports Prefab generation that reconstruct generated Sprites to original art asset layout
      • Prefab generation supports GameObject grouping based on Adobe Photoshop layer grouping
    • Supports 2D Animation v2 single character with multiple Sprites workflow
    In This Article
    Back to top
    Copyright © 2026 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)