ShotwellShotwell
Help

Troubleshooting

Fast checks for import, editing, preview, and export issues.

Quick triage

  1. Reproduce with one image and a minimal set of steps.
  2. Identify where it fails:
    • Import
    • Editing
    • Preview
    • Export
  3. Restart the app and retry the same path.

Common issue clusters

Import fails or does nothing

  • Try a second image to isolate source-specific issues.
  • Re-open picker and retry.
  • Confirm source image still exists in your library.

Preview looks wrong after background or frame changes

  • Confirm active background mode is the one you intended.
  • Re-apply frame device/color after orientation changes.
  • Check notch mode only on notch-enabled frames.

Composition looks clipped or off-center

  • Reset zoom/position and rebuild.
  • Recheck crop ratio.
  • Set frame orientation before final crop.

Export looks blurry

  • Export at 1x first.
  • Use PNG for UI clarity.
  • Avoid 2x when source resolution is limited.

Next step

If issue still reproduces, continue with Support.

On this page