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