# Application Media and Gallery: Asset Version History

A file version history with a header, then ruled rows per version showing a thumbnail, change note, uploader, timestamp, size, and restore action.

- Page: https://www.shadcn-ui-blocks.com/blocks/application-pro/media-gallery/asset-version-history
- Collection: [Application](https://www.shadcn-ui-blocks.com/blocks/application-pro), Standard tier
- Group: [Media and Galleries](https://www.shadcn-ui-blocks.com/blocks/application-pro/media-gallery)
- Created: 2026-07-04
- Preview image: https://www.shadcn-ui-blocks.com/blocks/application-pro/media-gallery/asset-version-history.png

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/application-pro-media-gallery-asset-version-history
```

Needs an API key from a Pro or Team plan: add `@shadcn-ui-blocks` to the registries in components.json with the key as an `Authorization: Bearer` header. Setup: https://www.shadcn-ui-blocks.com/docs/shadcn-cli. The MCP server installs it without the setup: https://www.shadcn-ui-blocks.com/docs/mcp.

## Depends on

- npm packages: class-variance-authority, lucide-react, radix-ui
- shadcn/ui components: avatar, avatars, badge, button, placeholder
- Installs to: `@/components/blocks/application-pro/media-gallery/asset-version-history`

## About this block

Asset Version History is the revision log for a single
file: a header pairing a Placeholder thumbnail with the
filename launch-banner.jpg and its full path, plus a
5 versions badge. Below it a ruled list runs newest to
oldest, each row carrying a thumbnail, a version number,
a change note (Replaced with the final color pass), an
uploader avatar with name, a timestamp, and a size. The
current version is highlighted and shows a Current badge
with no restore button; older rows offer Download and
Restore actions.

Versions are one array with a current flag that drives
both the row highlight and the branch between the Current
badge and the Restore button. A footer notes that
restoring keeps newer versions in history and that
versions older than 90 days are removed automatically.

## When to use

Reach for this block in an asset inspector or drawer when
a file has been revised and users need to review or roll
back a change, wired to your versioning endpoint. Gate
the Restore action on write permission.

A natural flow around it on an Application Pro page:

**Before**

- [Asset detail panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/media-gallery)
- [Media library grid](https://www.shadcn-ui-blocks.com/blocks/application-pro/media-gallery)

**After**

- [Image crop blueprint](https://www.shadcn-ui-blocks.com/blocks/application-pro/media-gallery)
- [Comments and annotations](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations)

## What you can display

One strong use is the image revision log. Other history
views:

- **Document versions.** Replace thumbnails with page
  counts and show a diff link between revisions.
- **Named releases.** Tag key versions with a label like
  Approved or Published.
- **Compare mode.** Add a checkbox on two rows to open a
  side by side comparison.

> Tip: highlight the current version and hide its restore
> button; there is nothing to roll back to when the newest
> revision is already live.

## More in Application Media and Galleries

- [Album List](https://www.shadcn-ui-blocks.com/blocks/application-pro/media-gallery/album-list)
- [Asset Detail Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/media-gallery/asset-detail-panel)
- [Bulk Media Actions](https://www.shadcn-ui-blocks.com/blocks/application-pro/media-gallery/bulk-media-actions)
- [Folder Breadcrumb Bar](https://www.shadcn-ui-blocks.com/blocks/application-pro/media-gallery/folder-breadcrumb-bar)
- [Image Crop Blueprint](https://www.shadcn-ui-blocks.com/blocks/application-pro/media-gallery/image-crop-blueprint)
- [Lightbox Blueprint](https://www.shadcn-ui-blocks.com/blocks/application-pro/media-gallery/lightbox-blueprint)
- [Media Library Grid](https://www.shadcn-ui-blocks.com/blocks/application-pro/media-gallery/media-library-grid)
- [Media List View](https://www.shadcn-ui-blocks.com/blocks/application-pro/media-gallery/media-list-view)
- [Storage Usage Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/media-gallery/storage-usage-panel)
- [Upload Queue Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/media-gallery/upload-queue-panel)
- [Video Trim Blueprint](https://www.shadcn-ui-blocks.com/blocks/application-pro/media-gallery/video-trim-blueprint)
