Skip to content

Unsplash Integration

Search Unsplash for a photo and add it to a slide through Deckyard’s image library.

Set UNSPLASH_ACCESS_KEY on the Deckyard server, then enable Unsplash as a stock media source in the admin settings. Both the key and the admin toggle are required before Unsplash appears in the image picker.

  1. Open an image field in the editor and choose Image library.
  2. Open Unsplash and search. Results load 20 at a time.
  3. Select a photo. Deckyard requests the regular-size image, calls Unsplash’s download-tracking endpoint, and adds the photo to your image library.

The imported image is stored in the server’s local uploads directory, even when the instance uses S3 for other uploads. Back up the local uploads directory if you use Unsplash images.

Deckyard shows the photographer’s name and profile link in the picker. Its image-library entry keeps the photographer’s name and the original photo URL. Deckyard does not create a credits slide automatically; add one if your presentation needs visible credits.

Deckyard caps each Unsplash search request at 30 results; the picker requests 20. Unsplash controls API-key quotas. If the source is missing, check both UNSPLASH_ACCESS_KEY and the admin toggle. If a search fails, check the server log and the key’s status in your Unsplash account.