Sharing

What can be shared?

StashSync.app can publish four kinds of content to public links:

Each share modal has the same shape — a status banner, the link, a Show on your profile link (when your profile is enabled), and a Stop sharing action with a confirm dialog — but the details differ by type.

Sharing a note

1. Open the note and click Share in the header, or use the ⋮ menu on a note card.
2. In the Share Note modal, pick a Link Expiration: No expiry, 24 hours, 7 days, or 30 days.
3. Click Create share link — your note is published as a snapshot at <username>.stashsync.app/s/n/<id>/<slug>.
4. Copy the URL with the copy icon, or open it in a new tab with the external-link icon.

If your public profile is on, a Show on your profile link appears in the modal once the note is shared — it takes you to the Public Profile page where you can add the note to your profile.

Status and view count

Once published, the modal's status banner switches to Publicly shared with a globe icon. An eye icon + number appears on the right showing how many times the public page has been viewed.

Republishing after edits

A note's public page is a snapshot — it doesn't update automatically when you edit the note. If you've changed the note since publishing, the share modal flags it with an amber notice and a Republish button appears in the footer next to Stop sharing. Click it to push the latest title and content to the same URL; the link doesn't change.

Stop sharing

The Stop sharing button opens a confirmation dialog ("Stop sharing this note?") before taking the link offline. Once confirmed, the public URL stops working immediately and the note disappears from your profile and from any shared collection it was part of. Sharing the note again later generates a new URL — old links stay dead.

Sharing a file

Files are shared via a token-based link on the main StashSync domain: stashsync.app/s/<token>. Unlike notes and collections, file shares don't use your username/subdomain — so you can share files even without claiming a username.

Sharing it

1. Click ⋮ → Share on a file card, or open the file preview and use the share option there.
2. In the Share File modal:
   • Title — defaults to the filename, but you can rename it. Visitors see this title on the shared page; the underlying file stays unchanged.
   • Link Expiration — No expiry, 24 hours, 7 days, or 30 days.
3. Click Create share link. Copy the URL with the copy icon, or open the public page with the external-link icon.

Download count

Once a file is shared, the status banner shows a download counter (download icon + number) reflecting how many times the file has been downloaded through the public link.

Showing it on your profile

Sharing a file doesn't list it on your profile. Once it's shared, a Show on your profile link appears in the modal (when your profile is enabled) — it opens the Public Profile page, where the file shows up under Available to add in the Files tab. Removing it there later hides it from your profile without unsharing; the download link keeps working.

Expiry

If you picked an expiration, the modal shows the expiry date below the link. When that date passes, the link stops working automatically — the file itself isn't deleted. To extend access, click Stop sharing and create a fresh link.

Stop sharing

Click Stop sharing in the footer. A confirmation dialog appears: "Stop sharing this file?" — "The download link will stop working and the file will no longer be reachable from your profile." Confirming invalidates the token immediately; anyone who follows the old link sees a "not found" page. Sharing the file again later generates a new token — old links stay dead.

Sharing a bookmark

Bookmarks don't get their own public StashSync page. "Sharing" a bookmark marks it as public so it becomes eligible to surface in two places:

• Your public profile, once you add it there from the Public Profile page.
• Any shared collection that contains the bookmark.

The link you'd send to someone is the bookmark's own URL — StashSync doesn't proxy or wrap it.

Sharing it

1. Click ⋮ → Share on a bookmark card, or use the share option in the bookmark detail view.
2. The Share Bookmark modal opens.
3. Click Share publicly. The bookmark is now public (eligible for shared collections) but not on your profile until you add it there.

The status banner switches to Publicly shared — Can appear in shared collections and the modal reveals the bookmark's URL with copy and open-in-new-tab icons.

Showing it on your profile

Once a bookmark is public, a Show on your profile link appears in the modal (when your profile is enabled) — it opens the Public Profile page, where the bookmark shows up under Available to add in the Bookmarks tab. Removing it there later hides it from your profile without unsharing it — it'll still appear in any shared collection it's part of.

No snapshot, no Republish

Bookmarks don't have a snapshot model the way notes and collections do. Whatever title, description, and preview image the bookmark currently has is what shows up wherever it's surfaced — edit the bookmark and the change is reflected next time the profile or shared collection is rendered. There's no Republish button.

Stop sharing

Click Stop sharing in the footer. A confirmation dialog appears: "Stop sharing this bookmark?" — "The bookmark will go private and be removed from your profile and any shared collections." Confirming makes the bookmark private and the server auto-republishes any collection that included it so the bookmark is dropped from those public pages.

Sharing a collection (stash)

A shared collection bundles the publicly shared items inside a stash onto a single page at <username>.stashsync.app/s/c/<id>/<slug>. Only items that are themselves public appear on the public page — publishing a collection never exposes private items.

The items panel

Open the stash and click Share to open the Share Collection modal. The center of the modal is an items panel that lists every active note, file, and bookmark in the stash, grouped by type:

• The section header shows a running count: Items · 3/8 shared.
• Each group (Notes → Files → Bookmarks) has its own collapsible header with a per-group count and a Share all / Unshare all shortcut that flips every shareable item in that group.
• Each row has a toggle. Flipping it on publishes that item publicly so it becomes eligible for the collection; flipping it off makes that item private again. Items shared this way don't get auto-listed on your profile — the collection itself is the profile entry, not its members.
• Bookmarks without a URL show a disabled toggle with the hint "Add a URL to this bookmark before sharing."

When the stash holds more than 6 items, a search box and All / Shared / Unshared filter pills appear above the list so you can narrow it down.

Publishing the collection

1. Use the item toggles to mark which notes, files, and bookmarks should appear in the public collection.
2. Click Create share link. The modal reveals the public URL with copy and open-in-new-tab icons.

Snapshots and Republish

A published collection is a snapshot of which items were public when you clicked publish. Adding a public item to the stash, removing one, or re-sharing a note (which changes its share ID) doesn't update the public page automatically. The modal detects drift with a fingerprint hash and shows an amber notice:

The shared items changed since you last published. Use Republish to update the public collection.

Click the Republish button in the footer to refresh the public page with the current members. The URL stays the same.

Showing it on your profile

Once the collection is public, a Show on your profile link appears in the modal (when your profile is enabled) — it opens the Public Profile page, where the collection shows up under Available to add in the Collections tab. Removing it there later hides it from your profile without unpublishing — the public URL keeps working.

Stop sharing

Click Stop sharing in the footer. A confirmation dialog appears: "Stop sharing this collection? — The public link will stop working. Items in this collection stay published unless you stop sharing them individually." Confirming takes the collection's public page offline. The underlying notes, files, and bookmarks stay public — only the collection wrapper goes away. Use each item's own share modal if you also want to stop sharing them individually.

Profile listing vs. public link

Being public and being listed on your profile are two independent states:

• A public link makes an item reachable to anyone who has the URL.
• A profile listing also surfaces the item on your <username>.stashsync.app profile page.

You can have a public item that isn't listed on your profile (handy for one-off links you only want to send to specific people). You can't list something on the profile without making it public — making it public is the prerequisite for listing it.

Sharing an item never lists it on your profile. The two steps are deliberately separate: share first to get a public link, then — if you want it on your profile — add it from the Public Profile page. Each share modal includes a Show on your profile link that takes you straight there.

See the Public Profile page for the full profile editor.

Stop sharing and expiry

Re-sharing a previously stopped or expired item generates a new unique URL (new share ID for notes/collections, new token for files). Old links stay dead.

Search-engine indexing

Public StashSync pages send a noindex directive to crawlers by default. Turn on Show in search engines in Settings → Public profile to opt every public surface (profile, notes, files, collections) into indexing.