# sanity-plugin-asset-source-unsplash > Use images from Unsplash.com in your Sanity Studio Latest version **7.0.30** (published 2026-10-23) · MIT license · 0 weekly downloads ## Install ```sh npm install sanity-plugin-asset-source-unsplash pnpm add sanity-plugin-asset-source-unsplash yarn add sanity-plugin-asset-source-unsplash bun add sanity-plugin-asset-source-unsplash ``` ## Health **Score 70/100 (B)** — status: active. Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score. Warnings: low downloads. ## Facts | | | |---|---| | Version | 7.0.30 | | Published | 2026-10-23 | | First published | 2019-11-12 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | ESM | | Node | >=20.19 <22 \|\| >=22.12 | | Dependencies | 4 | | Unpacked size | 64.8 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Provenance | attested (GitHub Actions) | | GitHub stars | 20 | | Author | Sanity.io | | Maintainers | bjoerge, skogsmaskin, sanity-svc.npm, sanity-io, vicbergquist | | Keywords | assets, images, plugin, sanity, source, unsplash | ## Links - npm: https://www.npmjs.com/package/sanity-plugin-asset-source-unsplash - Repository: https://github.com/sanity-io/plugins - Homepage: https://github.com/sanity-io/plugins/tree/main/plugins/sanity-plugin-asset-source-unsplash#readme - Issues: https://github.com/sanity-io/plugins/issues - npm.io page: https://npm.io/package/sanity-plugin-asset-source-unsplash ## Dependencies (4) - [lodash-es](https://npm.io/package/lodash-es.md) ^4.18.1 - [@sanity/ui](https://npm.io/package/@sanity/ui.md) ^4.4.9 - [@sanity/icons](https://npm.io/package/@sanity/icons.md) ^5.2.3 - [react-photo-album](https://npm.io/package/react-photo-album.md) ^3.6.0 ## Alternatives - [exif-parser](https://npm.io/package/exif-parser.md) — 3.8M weekly downloads - [vite-plugin-compression](https://npm.io/package/vite-plugin-compression.md) — 569.5K weekly downloads - [pica](https://npm.io/package/pica.md) — 442.4K weekly downloads - [@reportportal/client-javascript](https://npm.io/package/@reportportal/client-javascript.md) — 408.8K weekly downloads - [@tldraw/state](https://npm.io/package/@tldraw/state.md) — 316.0K weekly downloads ## Recent versions - 7.0.30 (latest) — 2026-10-23 - 7.0.3-canary.1 (canary) — 2026-01-06 - 1.0.7-beta.1 (beta) — 2023-05-23 - 0.2.5 (studio-v2) — 2022-11-22 - 3.0.0-v3-studio.13 (studio-v3) — 2022-11-04 - 1.0.0-purple-unicorn-starter.1 (purple-unicorn-starter) — 2022-10-14 - 7.0.29 — 2026-10-13 - 7.0.28 — 2026-10-12 - 7.0.27 — 2026-10-08 - 7.0.26 — 2026-09-29 - 7.0.25 — 2026-08-21 - 7.0.24 — 2026-08-20 - 7.0.23 — 2026-08-11 - 7.0.22 — 2026-08-10 - 7.0.21 — 2026-07-23 - … 92 more at https://npm.io/package/sanity-plugin-asset-source-unsplash/versions ## README # Sanity Asset Source Plugin: Unsplash ## What is it? Search for photos on Unsplash and add them to your project right inside Sanity Studio. ![Unsplash image selector](https://github.com/sanity-io/sanity-plugin-asset-source-unsplash/assets/81981/561c041f-bfe7-4c81-a93e-537d02da2664) ## Installation `npm install --save sanity-plugin-asset-source-unsplash` or `yarn add sanity-plugin-asset-source-unsplash` ## Usage Add it as a plugin in sanity.config.ts (or .js): ```js import {unsplashImageAsset} from 'sanity-plugin-asset-source-unsplash' export default defineConfig({ // ... plugins: [unsplashImageAsset()], }) ``` This will add [unsplashAssetSource](src/index.ts) to all image-fields in Sanity Studio ### Manually configure asset sources If you need to configure when Unsplash should be available as an asset source, filter it out as needed in `form.image.assetSources`: ```js import {unsplashImageAsset, unsplashAssetSource} from 'sanity-plugin-asset-source-unsplash' export default defineConfig({ // ... plugins: [unsplashImageAsset()], form: { image: { assetSources: (previousAssetSources, {schema}) => { if (schema.name === 'movie-image') { // remove unsplash from movie-image types return previousAssetSources.filter((assetSource) => assetSource !== unsplashAssetSource) } return previousAssetSources }, }, }, }) ``` ## Example Unsplash API Photo result ```json { "id": "1_CMoFsPfso", "created_at": "2016-08-27T05:14:20-04:00", "updated_at": "2019-11-07T00:01:26-05:00", "promoted_at": "2016-08-27T05:14:20-04:00", "width": 6016, "height": 4016, "color": "#170801", "description": "Minimal pencils on yellow", "alt_description": "two gray pencils on yellow surface", "urls": { "raw": "https://images.unsplash.com/photo-1472289065668-ce650ac443d2?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEwMDg3MX0", "full": "https://images.unsplash.com/photo-1472289065668-ce650ac443d2?ixlib=rb-1.2.1&q=85&fm=jpg&crop=entropy&cs=srgb&ixid=eyJhcHBfaWQiOjEwMDg3MX0", "regular": "https://images.unsplash.com/photo-1472289065668-ce650ac443d2?ixlib=rb-1.2.1&q=80&fm=jpg&crop=entropy&cs=tinysrgb&w=1080&fit=max&ixid=eyJhcHBfaWQiOjEwMDg3MX0", "small": "https://images.unsplash.com/photo-1472289065668-ce650ac443d2?ixlib=rb-1.2.1&q=80&fm=jpg&crop=entropy&cs=tinysrgb&w=400&fit=max&ixid=eyJhcHBfaWQiOjEwMDg3MX0", "thumb": "https://images.unsplash.com/photo-1472289065668-ce650ac443d2?ixlib=rb-1.2.1&q=80&fm=jpg&crop=entropy&cs=tinysrgb&w=200&fit=max&ixid=eyJhcHBfaWQiOjEwMDg3MX0" }, "links": { "self": "https://api.unsplash.com/photos/1_CMoFsPfso", "html": "https://unsplash.com/photos/1_CMoFsPfso", "download": "https://unsplash.com/photos/1_CMoFsPfso/download", "download_location": "https://api.unsplash.com/photos/1_CMoFsPfso/download" }, "categories": [], "likes": 4450, "liked_by_user": false, "current_user_collections": [], "user": { "id": "kA9qRJtrtA4", "updated_at": "2019-11-12T05:10:00-05:00", "username": "joannakosinska", "name": "Joanna Kosinska", "first_name": "Joanna", "last_name": "Kosinska", "twitter_username": "joannak.co.uk", "portfolio_url": null, "bio": null, "location": "Leeds", "links": { "self": "https://api.unsplash.com/users/joannakosinska", "html": "https://unsplash.com/@joannakosinska", "photos": "https://api.unsplash.com/users/joannakosinska/photos", "likes": "https://api.unsplash.com/users/joannakosinska/likes", "portfolio": "https://api.unsplash.com/users/joannakosinska/portfolio", "following": "https://api.unsplash.com/users/joannakosinska/following", "followers": "https://api.unsplash.com/users/joannakosinska/followers" }, "profile_image": { "small": "https://images.unsplash.com/profile-1477941848765-f577d5c83681?ixlib=rb-1.2.1&q=80&fm=jpg&crop=faces&cs=tinysrgb&fit=crop&h=32&w=32", "medium": "https://images.unsplash.com/profile-1477941848765-f577d5c83681?ixlib=rb-1.2.1&q=80&fm=jpg&crop=faces&cs=tinysrgb&fit=crop&h=64&w=64", "large": "https://images.unsplash.com/profile-1477941848765-f577d5c83681?ixlib=rb-1.2.1&q=80&fm=jpg&crop=faces&cs=tinysrgb&fit=crop&h=128&w=128" }, "instagram_username": "joannak.co.uk", "total_collections": 26, "total_likes": 534, "total_photos": 209, "accepted_tos": true } } ``` ## Example resulting asset document ```json { "ms": 7, "query": "*[_type == \"sanity.imageAsset\" \u0026\u0026 _id == \"image-a6904e5887baafcf72f686cfa3e98399fd3ff74a-2600x1548-jpg\"]", "result": [ { "_createdAt": "2019-11-14T09:01:47Z", "_id": "image-a6904e5887baafcf72f686cfa3e98399fd3ff74a-2600x1548-jpg", "_rev": "fDOLlTLScw9kMkHEI4HC9S", "_type": "sanity.imageAsset", "_updatedAt": "2019-11-14T09:01:47Z", "assetId": "a6904e5887baafcf72f686cfa3e98399fd3ff74a", "creditLine": "Qingbao Meng by Unsplash", "extension": "jpg", "metadata": { "_type": "sanity.imageMetadata", "dimensions": { "_type": "sanity.imageDimensions", "aspectRatio": 1.6795865633074936, "height": 1548, "width": 2600 }, "hasAlpha": false, "isOpaque": true, "lqip": "data:image/jpeg;base64,/9j/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/2wBDAQcHBwoIChMKChMoGhYaKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCj/wAARCAAMABQDASIAAhEBAxEB/8QAFwAAAwEAAAAAAAAAAAAAAAAAAAUHBv/EACMQAAIBAgYCAwAAAAAAAAAAAAECAwAEBQYREiExFDJBUWH/xAAWAQEBAQAAAAAAAAAAAAAAAAACAwX/xAAcEQACAgIDAAAAAAAAAAAAAAAAAQIREiFBUaH/2gAMAwEAAhEDEQA/AMbh2arnaqvdggfR1ppc52eOMi3V5SOyTwKjOFsxLNvbj9pniU81t4whlcCT2GvdZ8080RUK5KHNm6F33SBlfTkCiptcXkwk03dD5op2uvRbP//Z", "palette": { "_type": "sanity.imagePalette", "darkMuted": { "_type": "sanity.imagePaletteSwatch", "background": "#435c39", "foreground": "#fff", "population": 6.83, "title": "#fff" }, "darkVibrant": { "_type": "sanity.imagePaletteSwatch", "background": "#698710", "foreground": "#fff", "population": 2.51, "title": "#fff" }, "dominant": { "_type": "sanity.imagePaletteSwatch", "background": "#728863", "foreground": "#fff", "population": 6.83, "title": "#fff" }, "lightMuted": { "_type": "sanity.imagePaletteSwatch", "background": "#bec6a9", "foreground": "#000", "population": 0.51, "title": "#fff" }, "lightVibrant": { "_type": "sanity.imagePaletteSwatch", "background": "#cad67e", "foreground": "#000", "population": 0.62, "title": "#000" }, "muted": { "_type": "sanity.imagePaletteSwatch", "background": "#728863", "foreground": "#fff", "population": 6.83, "title": "#fff" }, "vibrant": { "_type": "sanity.imagePaletteSwatch", "background": "#91b31a", "foreground": "#000", "population": 1.83, "title": "#fff" } } }, "mimeType": "image/jpeg", "originalFilename": "2bb1b89b-726e-4d1c-a148-7936f57a432f.jpeg", "path": "images/q2r21cu7/example/a6904e5887baafcf72f686cfa3e98399fd3ff74a-2600x1548.jpg", "sha1hash": "a6904e5887baafcf72f686cfa3e98399fd3ff74a", "size": 1101084, "source": { "id": "01_igFr7hd4", "name": "unsplash", "url": "https://unsplash.com/photos/01_igFr7hd4" }, "url": "https://cdn.sanity.io/images/q2r21cu7/example/a6904e5887baafcf72f686cfa3e98399fd3ff74a-2600x1548.jpg" } ] } ``` ## Further reading - https://unsplash.com/documentation - https://www.sanity.io/docs/custom-asset-sources ## License MIT-licensed. See LICENSE. --- _Source: https://npm.io/package/sanity-plugin-asset-source-unsplash · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._