Commands
file show
Show detailed metadata for a file or folder.
poly file show prints detailed metadata for a file or folder — name, size, tags, rating, custom properties, and more — without downloading any bytes.
Usage
poly file show [TARGET]
TARGET defaults to .. It accepts a local path inside the sync folder, a //-prefixed Poly path, a deep link, or a web URL — see How it Works for the full reference syntax.
Flags
| Flag | Description |
|---|---|
--at <REVISION|TIME> | Show metadata as of a revision ID (from file history) or a fuzzy time, e.g. "yesterday" or "June 26 8pm". Conflicts with --path. |
--id | Print only the bare short ID. |
--url | Print only the web URL. With --at, appends /rev/<revision>. |
--app-url | Print only the polyapp:// deep link. |
--path | Print only the local on-disk path. Conflicts with --at. |
--id, --url, --app-url, and --path are mutually exclusive.
Examples
# Inspect a file by Poly path
poly file show //Home/docs/report.pdf
# Show metadata as of yesterday
poly file show //Home/docs/report.pdf --at yesterday
# Show metadata at a specific revision
poly file show //Home/docs/report.pdf --at rev_2f8a91
# Print just the web URL for sharing in chat
poly file show //Home/docs/report.pdf --url
# Get the local path and open it in an editor
vim "$(poly file show //Home/notes.md --path)"
Related
file history— list the revisions you can pass to--at.file read— print file contents instead of metadata.file open— open the file in a native application.- How it Works — file reference syntax and the local cache.