Bookmarks

Poly can store a web link as a file. Bookmarks sit in your folders next to regular files — they can be tagged, searched, shared, and organized like anything else, and on the desktop they appear as native bookmark files you can double-click.

Creating a bookmark

• In the app — paste or drag a URL into a folder.
• From the terminal — poly mkurl:

poly mkurl //Home/reading https://example.com/great-article

• From your browser — drag a URL out of the address bar and drop it into the sync folder.

A bookmark is a zero-byte file whose only substance is its destination URL — there's nothing to download and it takes no space in your quota.

How bookmarks appear in the sync folder

In the desktop sync folder, each bookmark materializes as a .webloc file — the standard macOS internet-location format — named after its URL. Double-clicking one opens the link in your default browser, exactly like a bookmark saved from Safari.

.webloc files in the sync folder are read-only: to change a bookmark's destination, create a new one. Renaming, tagging, moving, and archiving all work normally.

Dropping bookmark files in

The reverse direction works too. Drop a .webloc file into the sync folder and Poly recognizes it and stores it as a proper link file rather than uploading raw bytes. Windows-style .url shortcut files are also understood: they become the same kind of link file, with the .url extension stripped from the name — so a bookmark is the same thing in Poly no matter where it came from.

YouTube and other rich links

Poly recognizes certain kinds of URLs and gives them richer treatment:

• YouTube videos: a bookmark to a YouTube URL (any form: youtube.com/watch, youtu.be/…, mobile links) receives the YouTube video type. It gets the video's thumbnail as its preview image, and opening it inside the Poly app plays the video in an embedded player.
• Google Docs — links to Google documents are recognized and typed accordingly.

Other links open in a web preview inside the app when the destination site allows embedding; when it doesn't, the desktop app renders the preview natively, and the web client offers to open the link directly.

Searching bookmarks

Bookmarks are indexed like everything else. Find them by name, by tag, or with link-specific filters:

# All bookmarks under //Home
poly search --has-link --under //Home

# Bookmarks pointing at a specific site
poly search --link-url "*example.com*"