Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
Full File, Privately Shared entry
How-to guide

How to set a file to Privately Shared

Setting a file to Privately Shared is implicit: any sharing action on a Private file (with specific users, groups, or records) transitions to this state. The platform computes the state from the resulting links.

By Dipojjal Chakrabarti · Founder & Editor, Salesforce DictionaryLast updated May 21, 2026

Setting a file to Privately Shared is implicit: any sharing action on a Private file (with specific users, groups, or records) transitions to this state. The platform computes the state from the resulting links.

  1. Start with a Private or new file

    Upload a file to the Files tab or open an existing Private file.

  2. Click Share

    On the file detail page, click Share. The Share dialog opens.

  3. Add users, groups, or records

    Search for and add the users, groups, or records who should have access. Pick the right ShareType (Viewer or Collaborator).

  4. Save the sharing

    Click Done. The ContentDocumentLink records are created. The file is now Privately Shared.

  5. Verify the privacy state

    Open the file. The privacy state appears as Privately Shared. Check the sharing list to confirm the right users have access.

  6. Adjust as needed

    Add or remove users to refine sharing. Each change updates the privacy state if it changes the underlying link composition.

Key options
Share with specific usersremember

Add ContentDocumentLink records per user.

Share with Public Groupsremember

Group members inherit the file access.

Link to recordsremember

Users with record access see the file via the record relationship.

Publish to Librariesremember

Library members get access per Library permissions.

Gotchas
  • Records with broad sharing (Public Read/Write OWD) effectively make linked files org-wide visible. Check record sharing before sharing files via records.
  • Multiple sharing methods stack: a user can be a Collaborator via direct link, a Viewer via group membership, and an Owner via record sharing. The user gets the strongest permission.
  • Sharing a file on a record cascades to users with record access. If the record is shared with everyone, the file effectively transitions to Your Company state.
  • Removing the last non-Owner ContentDocumentLink reverts to Private state automatically. Useful for retracting collaboration; surprise to users who relied on the file appearing.

See the full File, Privately Shared entry

File, Privately Shared includes the definition, worked example, deep dive, related terms, and a quiz.