User Guide Cancel

Basic troubleshooting steps to fix most issues

  1. Photoshop User Guide
  2. Introduction to Photoshop
    1. Dream it. Make it.
    2. What's new in Photoshop
    3. Edit your first photo
    4. Create documents
    5. Photoshop | Common Questions
    6. Photoshop system requirements
    7. Get to know Photoshop
    8. Keep Photoshop up to date
  3. Photoshop and other Adobe products and services
    1. Work with Illustrator artwork in Photoshop
    2. Work with Photoshop files in InDesign
    3. Substance 3D Materials for Photoshop
    4. Use the Capture in-app extension in Photoshop
  4. Photoshop on the iPad (not available in mainland China)
    1. Photoshop on the iPad | Common questions
    2. Get to know the workspace
    3. System requirements | Photoshop on the iPad
    4. Create, open, and export documents
    5. Add photos
    6. Work with layers
    7. Draw and paint with brushes
    8. Make selections and add masks
    9. Retouch your composites
    10. Work with adjustment layers
    11. Adjust the tonality of your composite with Curves
    12. Apply transform operations
    13. Crop and rotate your composites
    14. Rotate, pan, zoom, and reset the canvas
    15. Work with Type layers
    16. Work with Photoshop and Lightroom
    17. Get missing fonts in Photoshop on the iPad
    18. Japanese Text in Photoshop on the iPad
    19. Manage app settings
    20. Touch shortcuts and gestures
    21. Keyboard shortcuts
    22. Edit your image size
    23. Livestream as you create in Photoshop on the iPad
    24. Correct imperfections with the Healing Brush
    25. Create brushes in Capture and use them in Photoshop on the iPad
    26. Work with Camera Raw files
    27. Create and work with Smart Objects
    28. Adjust exposure in your images with Dodge and Burn
    29. Auto adjustment commands in Photoshop on the iPad
    30. Smudge areas in your images with Photoshop on the iPad
    31. Saturate or desaturate your images using Sponge tool
    32. Content aware fill for iPad
  5. Photoshop on the web (not available in mainland China)
    1. Common questions
    2. System requirements
    3. Keyboard shortcuts
    4. Supported file types
    5. Introduction to the workspace
    6. Open and work with cloud documents
    7. Generative AI features
    8. Basic concepts of editing
    9. Quick Actions
    10. Work with layers
    11. Retouch images and remove imperfections
    12. Make quick selections
    13. Image improvements with Adjustment Layers
    14. Add a fill layer
    15. Move, transform, and crop images
    16. Draw and paint
    17. Draw and edit Shapes
    18. Work with Type layers
    19. Work with anyone on the web
    20. Manage app settings
    21. Generate Image
    22. Generate Background
    23. Reference Image
  6. Photoshop (beta) (not available in mainland China)
    1. Get started with Creative Cloud Beta apps
    2. Photoshop (beta) on the desktop
    3. Reference Image
  7. Generative AI (not available in mainland China) 
    1. Common questions on generative AI in Photoshop
    2. Generative Fill in Photoshop on the desktop
    3. Generate Image with descriptive text prompts
    4. Generative Expand in Photoshop on the desktop
    5. Replace background with Generate background
    6. Get new variations with Generate Similar
    7. Generative Fill in Photoshop on the iPad
    8. Generative Expand in Photoshop on the iPad
    9. Generative AI features in Photoshop on the web
  8. Content authenticity (not available in mainland China)
    1. Content credentials in Photoshop
    2. Identity and provenance for NFTs
    3. Connect accounts for creative attribution
  9. Cloud documents (not available in mainland China)
    1. Photoshop cloud documents | Common questions
    2. Photoshop cloud documents | Workflow questions
    3. Manage and work with cloud documents in Photoshop
    4. Upgrade cloud storage for Photoshop
    5. Unable to create or save a cloud document
    6. Solve Photoshop cloud document errors
    7. Collect cloud document sync logs
    8. Invite others to edit your cloud documents
    9. Share files and comment in-app
  10. Workspace
    1. Workspace basics
    2. Preferences
    3. Learn faster with the Photoshop Discover Panel
    4. Create documents
    5. Place files
    6. Default keyboard shortcuts
    7. Customize keyboard shortcuts
    8. Tool galleries
    9. Performance preferences
    10. Use tools
    11. Presets
    12. Grid and guides
    13. Touch gestures
    14. Use the Touch Bar with Photoshop
    15. Touch capabilities and customizable workspaces
    16. Technology previews
    17. Metadata and notes
    18. Place Photoshop images in other applications
    19. Rulers
    20. Show or hide non-printing Extras
    21. Specify columns for an image
    22. Undo and history
    23. Panels and menus
    24. Position elements with snapping
    25. Position with the Ruler tool
  11. Web, screen, and app design
    1. Photoshop for design
    2. Artboards
    3. Device Preview
    4. Copy CSS from layers
    5. Slice web pages
    6. HTML options for slices
    7. Modify slice layout
    8. Work with web graphics
    9. Create web photo galleries
  12. Image and color basics
    1. How to resize images
    2. Work with raster and vector images
    3. Image size and resolution
    4. Acquire images from cameras and scanners
    5. Create, open, and import images
    6. View images
    7. Invalid JPEG Marker error | Opening images
    8. Viewing multiple images
    9. Customize color pickers and swatches
    10. High dynamic range images
    11. Match colors in your image
    12. Convert between color modes
    13. Color modes
    14. Erase parts of an image
    15. Blending modes
    16. Choose colors
    17. Customize indexed color tables
    18. Image information
    19. Distort filters are unavailable
    20. About color
    21. Color and monochrome adjustments using channels
    22. Choose colors in the Color and Swatches panels
    23. Sample
    24. Color mode or Image mode
    25. Color cast
    26. Add a conditional mode change to an action
    27. Add swatches from HTML CSS and SVG
    28. Bit depth and preferences
  13. Layers
    1. Layer basics
    2. Nondestructive editing
    3. Create and manage layers and groups
    4. Select, group, and link layers
    5. Place images into frames
    6. Layer opacity and blending
    7. Mask layers
    8. Apply Smart Filters
    9. Layer comps
    10. Move, stack, and lock layers
    11. Mask layers with vector masks
    12. Manage layers and groups
    13. Layer effects and styles
    14. Edit layer masks
    15. Extract assets
    16. Reveal layers with clipping masks
    17. Generate image assets from layers
    18. Work with Smart Objects
    19. Blending modes
    20. Combine multiple images into a group portrait
    21. Combine images with Auto-Blend Layers
    22. Align and distribute layers
    23. Copy CSS from layers
    24. Load selections from a layer or layer mask's boundaries
    25. Knockout to reveal content from other layers
  14. Selections
    1. Get started with selections
    2. Make selections in your composite
    3. Select and Mask workspace
    4. Select with the marquee tools
    5. Select with the lasso tools
    6. Adjust pixel selections
    7. Move, copy, and delete selected pixels
    8. Create a temporary quick mask
    9. Select a color range in an image
    10. Convert between paths and selection borders
    11. Channel basics
    12. Save selections and alpha channel masks
    13. Select the image areas in focus
    14. Duplicate, split, and merge channels
    15. Channel calculations
  15. Image adjustments
    1. Replace object colors
    2. Perspective warp
    3. Reduce camera shake blurring
    4. Healing brush examples
    5. Export color lookup tables
    6. Adjust image sharpness and blur
    7. Understand color adjustments
    8. Apply a Brightness/Contrast adjustment
    9. Adjust shadow and highlight detail
    10. Levels adjustment
    11. Adjust hue and saturation
    12. Adjust vibrance
    13. Adjust color saturation in image areas
    14. Make quick tonal adjustments
    15. Apply special color effects to images
    16. Enhance your image with color balance adjustments
    17. High dynamic range images
    18. View histograms and pixel values
    19. Match colors in your image
    20. Crop and straighten photos
    21. Convert a color image to black and white
    22. Adjustment and fill layers
    23. Curves adjustment
    24. Blending modes
    25. Target images for press
    26. Adjust color and tone with Levels and Curves eyedroppers
    27. Adjust HDR exposure and toning
    28. Dodge or burn image areas
    29. Make selective color adjustments
  16. Adobe Camera Raw
    1. Camera Raw system requirements
    2. What's new in Camera Raw
    3. Introduction to Camera Raw
    4. Create panoramas
    5. Supported lenses
    6. Vignette, grain, and dehaze effects in Camera Raw
    7. Default keyboard shortcuts
    8. Automatic perspective correction in Camera Raw
    9. Radial Filter in Camera Raw
    10. Manage Camera Raw settings
    11. Open, process, and save images in Camera Raw
    12. Repair images with the Enhanced Spot Removal tool in Camera Raw
    13. Rotate, crop, and adjust images
    14. Adjust color rendering in Camera Raw
    15. Process versions in Camera Raw
    16. Make local adjustments in Camera Raw
  17. Image repair and restoration
    1. Remove Tool
    2. Remove objects from your photos with Content-Aware Fill
    3. Content-Aware Patch and Move
    4. Retouch and repair photos
    5. Correct image distortion and noise
    6. Basic troubleshooting steps to fix most issues
  18. Image enhancement and transformation
    1. Replace sky in your images
    2. Transform objects
    3. Adjust crop, rotation, and canvas size
    4. How to crop and straighten photos
    5. Create and edit panoramic images
    6. Warp images, shapes, and paths
    7. Vanishing Point
    8. Content-aware scaling
    9. Transform images, shapes, and paths
  19. Drawing and painting
    1. Paint symmetrical patterns
    2. Draw rectangles and modify stroke options
    3. About drawing
    4. Draw and edit shapes
    5. Painting tools
    6. Create and modify brushes
    7. Blending modes
    8. Add color to paths
    9. Edit paths
    10. Paint with the Mixer Brush
    11. Brush presets
    12. Gradients
    13. Gradient interpolation
    14. Fill and stroke selections, layers, and paths
    15. Draw with the Pen tools
    16. Create patterns
    17. Generate a pattern using the Pattern Maker
    18. Manage paths
    19. Manage pattern libraries and presets
    20. Draw or paint with a graphics tablet
    21. Create textured brushes
    22. Add dynamic elements to brushes
    23. Gradient
    24. Paint stylized strokes with the Art History Brush
    25. Paint with a pattern
    26. Sync presets on multiple devices
    27. Migrate presets, actions, and settings
  20. Text
    1. Add and edit the text
    2. Unified Text Engine
    3. Work with OpenType SVG fonts
    4. Format characters
    5. Format paragraphs
    6. How to create type effects
    7. Edit text
    8. Line and character spacing
    9. Arabic and Hebrew type
    10. Fonts
    11. Troubleshoot fonts
    12. Asian type
    13. Create type
  21. Filters and effects
    1. Use the Blur Gallery
    2. Filter basics
    3. Filter effects reference
    4. Add Lighting Effects
    5. Use the Adaptive Wide Angle filter
    6. Use the Oil Paint filter
    7. Use the Liquify filter
    8. Layer effects and styles
    9. Apply specific filters
    10. Smudge image areas
  22. Saving and exporting
    1. Save your files in Photoshop
    2. Export your files in Photoshop
    3. Supported file formats
    4. Save files in graphics formats
    5. Move designs between Photoshop and Illustrator
    6. Save and export video and animations
    7. Save PDF files
    8. Digimarc copyright protection
  23. Color Management
    1. Understanding color management
    2. Keeping colors consistent
    3. Color settings
    4. Duotones
    5. Work with color profiles
    6. Color-managing documents for online viewing
    7. Color-managing documents when printing
    8. Color-managing imported images
    9. Proofing colors
  24. Web, screen, and app design
    1. Photoshop for design
    2. Artboards
    3. Device Preview
    4. Copy CSS from layers
    5. Slice web pages
    6. HTML options for slices
    7. Modify slice layout
    8. Work with web graphics
    9. Create web photo galleries
  25. Video and animation
    1. Video editing in Photoshop
    2. Edit video and animation layers
    3. Video and animation overview
    4. Preview video and animations
    5. Paint frames in video layers
    6. Import video files and image sequences
    7. Create frame animations
    8. Creative Cloud 3D Animation (Preview)
    9. Create timeline animations
    10. Create images for video
  26. Printing
    1. Print 3D objects
    2. Print from Photoshop
    3. Print with color management
    4. Contact Sheets and PDF Presentations
    5. Print photos in a picture package layout
    6. Print spot colors
    7. Print images to a commercial printing press
    8. Improve color prints from Photoshop
    9. Troubleshoot printing problems | Photoshop
  27. Automation
    1. Creating actions
    2. Create data-driven graphics
    3. Scripting
    4. Process a batch of files
    5. Play and manage actions
    6. Add conditional actions
    7. About actions and the Actions panel
    8. Record tools in actions
    9. Add a conditional mode change to an action
    10. Photoshop UI toolkit for plug-ins and scripts
  28. Troubleshooting
    1. Fixed issues 
    2. Known issues
    3. Optimize Photoshop performance
    4. Basic troubleshooting
    5. Troubleshoot crash or freeze
    6. Troubleshoot program errors
    7. Troubleshoot scratch disk full errors
    8. Troubleshoot GPU and graphics driver issues
    9. Find missing tools
    10. Photoshop 3D | Common questions around discontinued features

  As of July 2024, Photoshop’s legacy 3D features have been removed. However, now in the Photoshop (beta) app you can seamlessly add 3D objects to your 2D Photoshop design using the Adobe Substance 3D Viewer (beta) app. Click here for more details.

This document contains basic troubleshooting steps that should solve most problems you can encounter while using Photoshop. Try all the steps below before posting on the forum for Photoshop-specific issues.

Known issues in Photoshop

Check to see if the issue you're encountering is a known issue in the latest release of Photoshop.

See Known issues in Photoshop.

Get the latest Camera Raw support

The most commonly asked support question is "Photoshop doesn't recognize my new camera's raw files. How to I get Photoshop to open my raw files?"

See Photoshop or Lightroom doesn't support my camera.

Install application updates

You can fix many problems by simply making sure that your Adobe software is up-to-date.

See Keep Photoshop up to date.

Note:

Adobe provides technical support and security fixes for the current version and the prior version. Bug fixes are only provided for the current version. See Photoshop - Supported versions for complete details.

Install operating system updates

You can fix many problems by simply making sure your operating system is up-to-date.

Adobe recommends that you perform your own testing on a non-production partition to ensure that brand-new operating systems work well with your current hardware and drivers.

Creative Cloud doesn’t show available updates, or applications are in trial mode

Not seeing the available updates? Are your applications showing as trials?

See Available updates not listed.

I can't activate Photoshop, or applications are in trial mode

Not able to activate Photoshop, or applications are appearing as trials?

See Troubleshooting licensing errors | Creative Cloud.

Install graphics card (GPU) driver updates

If you're experiencing image rendering issues, slow performance, or crashes, the cause could be a defective, unsupported, or incompatible graphics driver.

See GPU and graphics driver troubleshooting steps.

Troubleshoot graphics processor

In some cases, having the latest driver may not cure all problems related to video adapters and drivers.

The quickest and easiest way to determine if the problem is with your video adapter or driver is to disable the Use Graphics Processor preference.

See Disable the GPU to quickly narrow down the issue.

For specific errors, see the following:

Restore preferences

Reverting Photoshop’s preferences to their factory-fresh state can solve many issues (including program errors, strange tool/interface behavior, etc).

See Restore preference files to default.

Troubleshoot plug-ins

Many issues can arise from using incompatible, outdated, or incorrectly installed plug-ins.

See Photoshop plug-ins troubleshooting.

Troubleshoot fonts

Many problems can occur when you use third-party fonts, including crashing or hangs when selecting the Type tool or when making the Character panel active/visible. A bad font or fonts can also cause general performance issues when launching or using Photoshop. Validate and remove duplicate or troublesome fonts to improve stability and text tool performance.

See Troubleshoot fonts.

Photoshop is crashing

If you perform all the steps above and you still encounter a crash, be sure to submit all crash reports. If you submit a crash report for a known issue to Adobe with your email address, we can email you a solution for correcting the problem.

See Interpret a Photoshop crash report.

Photoshop is slow or lags

Unexpected results using a tool

If a tool in Photoshop isn't working properly (for example, the crop tool crops a tiny little gray square, or painting with a brush paints the wrong color or nothing at all), try resetting the tool settings:

Reset Tool in current version of Photoshop

Legacy versions (CS6 and earlier)
  • Right-click (Windows) or Control-click (macOS) the Tool Preset Picker in the Tool options bar and choose Reset Tool to reset the active tool, or choose Reset All Tools to reset all tools to their factory default settings.
Reset Tool option in Photoshop CS6 and earlier

Troubleshoot cursor display or size issues

  • Crosshair: If you see a crosshair (Precise) cursor instead of the normal brush tip or other tool shape, try toggling the Caps Lock key off. 
  • Incorrect Brush size: On macOS, the painted result is smaller than the brush cursor size you see on screen, determine if you have an increased Cursor Size specified in your System Preferences: Accessibility > Display settings
(macOS) Check Cursor Size in System Preferences > Accessibility > Display settings.

Missing tools

If a tool or multiple tools are missing from the Toolbar, try resetting Toolbar customization to the default. To do this, select Edit > Toolbar and click Restore Defaults in the right-hand column.

See Tools missing from the toolbar.

Note:

If you've selected a workspace other than Essentials, each of the other workspaces in Photoshop customize the Toolbar to present a different set of tools. Selecting Window > Workspace > Essentials (Default) or Window > Workspace > Reset Essentials can also restore the default Toolbar.

You can also use the Discover panel within Photoshop to search and identify tools. Use the keyboard shortcut Command/Control + F  to get the search dialog box, type the name of the tool you're looking for and select the desired result. Photoshop will highlight and activate the tool in the UI.

See Learn faster with the Photoshop Discover Panel.

Troubleshoot user permissions

If none of the troubleshooting steps above solve your problem, your problem may be related to user permissions. 

Admin user account

Create an admin user account to identify permissions problems. For instructions on creating an admin user account, see the following: 

macOS:

Note:

Be sure to change the New Account pop-up window from Standard to Administrator when creating the user.

Windows:

After you create the admin user account, log in to the new user and run Photoshop to see if the problem goes away.

Non-admin user account

Start in safe mode

Sometimes, third-party extensions and other utilities can interfere with Photoshop’s operation.

If you start your computer in safe mode, third-party extensions and utilities are turned off, which can help solve your problem.

macOS:

  • Starting up in safe mode: On macOS, safe mode disables all third-party extensions and startup items. It runs only required kernel extensions and Apple-installed startup items.

Windows:

Troubleshoot update errors

Several update errors are caused by missing or modified files required by Photoshop, due to disk clean-up utilities such as CleanMyMac or MacKeeper. Keep your clean-up utilities up to date or discontinue its use.

If you're facing trouble installing Photoshop or Bridge updates, see Fix errors installing Creative Cloud apps.

If you're having trouble installing Camera Raw updates, see Camera Raw plug-in installer.

Collect logs and system info

In the unlikely event of a Photoshop crash or program error, the following sources of information provide vital clues for diagnosing what went wrong:

Additional troubleshooting

Try all the steps above before posting on the forum for Photoshop-specific issues.

If you have a how-to question or question about changes in behavior between Photoshop versions, see the following: 

If you need help with app installation/downloads or your Creative Cloud membership, see the following:

 Adobe

Get help faster and easier

New user?

Adobe MAX 2024

Adobe MAX

The Creativity Conference

Oct 14–16 Miami Beach and online

Adobe MAX 2024

Adobe MAX

The Creativity Conference

Oct 14–16 Miami Beach and online