Versions & history

Prophouse never overwrites a prop. Each time different bytes are pushed for it, a new immutable version is added to the prop’s history, and the prop’s current version usually moves to the newest one. You can inspect every version, pull any of them, and restore an earlier one as the current version.

How a new version is created

When you push, Prophouse decides for each file whether it is new, a new version of an existing prop, or something already in the library:

Bytes that already exist in the library are not stored again. The push reports them as already present and nothing new is published.
Assets that came from Prophouse carry a small provenance stamp (Unreal assets get it when they are pulled into a project). Pushing an edited copy of a stamped asset adds a new version to the same prop, with the version you started from as its parent.
Assets with no stamp start a new prop.
If an unstamped asset looks like it belongs to an existing prop (for example, it shares an Unreal package GUID with one), the push holds it and asks you to decide: attach it to that prop as a new version, or register it as a separate prop.

A new version becomes the prop’s current version unless it is published as a labeled variant (see Variants). The prop’s name, category (unless you locked it), metadata and thumbnail follow the current version.

If the prop is checked out by someone else, your push of a new version is held back until they check in or release the lock. See Check-out & check-in.

Open the version history

Open the prop in the Cloud Library.
Select the History tab.
In the Provenance card, next to Lineage, select View version history.

The Version history page lists every version of the prop as an indented tree: each version sits under the version it was made from, so branches are easy to spot. Each row shows:

A short content hash (hover for the full hash).
Current version on the version the prop is showing now.
variant: <label> when the version was published as a variant.
How the version was matched to this prop: Matched by stamp, Matched by GUID, New lineage (the first version of a prop), or Manually linked (someone chose to attach it during a push).
The asset name, file size, Unreal Engine version when known, who published it and when, and the pack it came from.

The page header links back to the prop. If the history belongs to an asset that only exists as a dependency of other props, the header says referenced as a dependency only and restore is not offered.

The History tab also has an Activity card listing what happened to the prop over time: pushes, restores, check-outs and releases, review changes, comments, markup and downloads.

Pull an earlier version

Every row on the Version history page has Pull this version, which opens the pull dialog pinned to that exact version. To fetch a specific version’s file from an agent, use get_version_history to find its content hash, then get_download_url.

Restore an earlier version

Restoring makes an earlier version the prop’s current version again. Nothing is deleted: the newer versions stay in the history and you can restore them later.

Open the Version history page for the prop.
On the version you want, select Restore this version.
Select Confirm restore.

You’ll see Version restored. and the prop’s name, metadata, thumbnail and review badge now come from the restored version. If that version was approved, the prop shows Approved again. The restore is recorded in the prop’s activity.

Any member can restore a version, unless someone else has the prop checked out. While another person holds the lock, the restore fails with This asset is checked out by another user. Ask them to check in or release it, or wait for the lock to lapse. Admins can restore a locked prop, and the lock holder can restore while holding it. Agents use restore_version with the prop’s entry_id and the version’s object_id. Only versions from the prop’s own history can be restored.

Variants

Prophouse has two kinds of variants.

Variants within one prop

A version can carry a variant label (for example “Worn”). In the Unreal plugin’s push window, turn on Advanced and fill in Variant label for an asset. When the asset is a stamped copy of an existing prop, the labeled version lands in that prop’s history without replacing its current version.

When a prop has labeled variants, its Overview tab shows a Variants of this asset card with one card per label (plus base for the unlabeled line). Each card is the newest version with that label, and the current version is marked current. Select the variants you want and use Pull selected variants (n). The n versions link opens the version history.

Variant groups

Separate props can be grouped as variants of each other, such as color or damage variants that were authored as different assets. In the Unreal push window, the Variant group column assigns assets to a group, and the push window can propose groups from naming conventions automatically.

A prop in a group shows a Variant badge with the group size, and its Overview tab shows a Variants card listing the siblings. Select a sibling to open it, or check several and use Pull selected variants (n).

get_version_history, restore_version and get_download_url cover these workflows for AI agents. See the tool reference.