Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
Full File entry
How-to guide

How to create a File in Salesforce

Files (ContentDocument records) are the modern Salesforce file storage — replacing the legacy Attachments and Documents objects. Files can be attached to multiple records, shared with users / groups / public links, and follow proper Sharing rules.

By Dipojjal Chakrabarti · Editor, Salesforce DictionaryLast updated Apr 28, 2026

Files (ContentDocument records) are the modern Salesforce file storage — replacing the legacy Attachments and Documents objects. Files can be attached to multiple records, shared with users / groups / public links, and follow proper Sharing rules.

  1. Open any record (or the Files tab)

    Files are most often created from a record's Files related list. Standalone files come from the Files tab.

  2. Click Upload Files (or drag-and-drop into the related list)

    Drag-and-drop is fastest; the file uploads in-place.

  3. Pick the file from your computer

    Salesforce caps individual files at 2 GB (with chunked upload) and total org file storage per edition.

  4. Wait for upload

    Progress bar shows. Larger files take longer; very large files use chunked upload behind the scenes.

  5. (Optional) set a description and tags

    Description aids search; tags group related files.

  6. (Optional) share with users / groups / records

    Files default to Privately Shared with the uploader. To share more broadly, click Share → add users / groups / public link.

Mandatory fields
File bodyrequired

Required — that's the whole point. Salesforce uploads the binary content.

Titlerequired

Required. Defaults to the original filename — editable after.

Gotchas
  • Files (ContentDocument) are different from Attachments (Attachment object). Old Attachment-based code references the wrong object — modern integrations should use ContentDocument exclusively.
  • Files default to Privately Shared with the uploader. Even if attached to a public record, the uploader is the only one who sees the file unless explicitly shared. Common confusion.
  • Salesforce file storage limits per-edition. Hitting the cap blocks new uploads org-wide. Monitor Setup → Storage Usage.

See the full File entry

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