​
What can you do with it?

The /sample-images command enables you to quickly find and use high-quality placeholder images from Unsplash. You can search for specific types of images, get multiple options, specify dimensions, and retrieve images for mockups, presentations, or testing without leaving your workflow.

​
How to use it?

​
Basic Command Structure

/sample-images [search-query]

​
Parameters

Required:

  • search-query - Description of the type of images you need

Optional:

  • count - Number of images to return (defaults to 5)
  • size - Image dimensions: small, medium, large, or custom (e.g., 800x600)
  • orientation - Image orientation: landscape, portrait, or square

​
Response Format

The command returns:

{
  "images": [
    {
      "url": "Unsplash image URL",
      "description": "image description",
      "photographer": "photographer name",
      "dimensions": "width x height"
    }
  ],
  "query": "search query used",
  "total_results": "number of images found"
}

​
Examples

​
Basic Usage

/sample-images modern office space

Returns 5 sample images of modern office spaces.

​
Advanced Usage

/sample-images nature landscapes
number of images: 10
size: large
orientation: landscape

Returns 10 large landscape-oriented nature images suitable for backgrounds or hero sections.

​
Specific Use Case

/sample-images team collaboration
number of images: 3
dimensions: 800x600

Gets 3 team collaboration images sized at 800x600 pixels for a presentation.

​
Notes

Image Sources:

  • All images from Unsplash’s free collection
  • High-quality, professional photography
  • Free to use with attribution
  • Direct URLs for immediate use