https://github.com/rubix-studios-pty-ltd/payload-images
A Payload CMS plugin that integrates with stock image providers including Unsplash, Pexels and Pixabay.
https://github.com/rubix-studios-pty-ltd/payload-images
image-search images nextjs payload payload-plugin payloadcms payloadcms-3 payloadcms-v3 pexels pixabay react stock unplash
Last synced: about 1 month ago
JSON representation
A Payload CMS plugin that integrates with stock image providers including Unsplash, Pexels and Pixabay.
- Host: GitHub
- URL: https://github.com/rubix-studios-pty-ltd/payload-images
- Owner: rubix-studios-pty-ltd
- License: mit
- Created: 2026-01-24T12:14:05.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-02-13T00:19:49.000Z (4 months ago)
- Last Synced: 2026-02-13T10:20:52.547Z (4 months ago)
- Topics: image-search, images, nextjs, payload, payload-plugin, payloadcms, payloadcms-3, payloadcms-v3, pexels, pixabay, react, stock, unplash
- Language: TypeScript
- Homepage: https://rubixstudios.com.au
- Size: 231 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# PayloadCMS Image Search Plugin
PayloadCMS plugin for stock image search across Unsplash, Pexels, and Pixabay, with filterable results and instant import.
This project is an independent implementation derived [PayloadBites' Image Search](https://github.com/rilrom/payload-bites/tree/main/packages/image-search) extended with provider-specific image filtering and improved Windows OS compatibility.
## Installation
```sh
pnpm add @rubixstudios/payload-images
```
```typescript
// payload.config.ts
import { buildConfig } from 'payload/config'
import { imagePlugin } from '@rubixstudios/payload-images'
export default buildConfig({
plugins: [
imagePlugin({
disabled: false, // Optional, defaults to false
access: ({ req: { user } }) => Boolean(user), // Image search access control
pexels: process.env.API_KEY_PEXELS!,
pixabay: process.env.API_KEY_PIXABAY!,
unsplash: process.env.API_KEY_UNSPLASH!,
}),
],
})
```
## Notes
API key can be obtained from the respective provider's website.
- [Unsplash](https://unsplash.com/developers)
- [Pexels](https://www.pexels.com/api/)
- [Pixabay](https://pixabay.com/api/docs/)
When using Unplash, utilise your Access Key for the API Token.
## Features
- Stock image search inside Payload Admin
- Providers: Unsplash, Pexels, Pixabay
- Provider-specific filters (color, orientation, size, type)
- Featured and keyword search modes
- One-click image import
- Permission-based access control
## Liability
Rubix Studios, its developers, and contributors bear no responsibility for how images are used.
Before using any provider, ensure you have reviewed and agreed to their terms and usage policies.
## Support
For support or inquiries:
- LinkedIn: [rubixvi](https://www.linkedin.com/in/rubixvi/)
- Website: [Rubix Studios](https://rubixstudios.com.au)
## Author
Rubix Studios Pty. Ltd.
[https://rubixstudios.com.au](https://rubixstudios.com.au)
## Acknowledgments
This project is based on the Image Search by Riley Langbein:
- [Riley Langbein](https://github.com/rilrom)