> ## Documentation Index
> Fetch the complete documentation index at: https://docs.filefetch.app/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Frequently asked questions about FileFetch

## General Questions

<AccordionGroup>
  <Accordion title="What is FileFetch?">
    FileFetch is a desktop application for exporting files from Salesforce. It allows you to bulk-download Salesforce Files (ContentVersion) and legacy Attachments to your local computer with advanced filtering, organization, and export options.
  </Accordion>

  <Accordion title="Is FileFetch free?">
    FileFetch offers a 14-day free trial. Pricing information is available at [filefetch.app/pricing](https://filefetch.app/pricing).
  </Accordion>

  <Accordion title="What platforms does FileFetch support?">
    FileFetch is available for:

    * macOS 10.15 (Catalina) or later
    * Windows 10 (64-bit) or later
  </Accordion>

  <Accordion title="Do you store my Salesforce credentials?">
    No. Your credentials are stored locally in your operating system's secure keychain (macOS Keychain or Windows Credential Manager). FileFetch never sends your credentials to our servers. All connections go directly from your computer to Salesforce.
  </Accordion>

  <Accordion title="Does my data go through FileFetch servers?">
    No. FileFetch connects directly from your computer to Salesforce. Files download straight from Salesforce to your local machine. We never see or store your data.
  </Accordion>
</AccordionGroup>

## Features & Capabilities

<AccordionGroup>
  <Accordion title="What's the difference between Files and Attachments?">
    * **Files (ContentVersion)**: Modern Salesforce Files introduced in Winter '12. Supports versioning, rich metadata, and is the current standard.
    * **Attachments**: Legacy attachment system from before Winter '12. No version support, simpler structure.

    Most modern Salesforce orgs use Files. Use Attachments export only for legacy data.
  </Accordion>

  <Accordion title="How many files can I export at once?">
    * **SOQL Query**: Up to 2000 files per query (Salesforce API limit)
    * **CSV Import**: No hard limit (processed in batches of 200)

    For large exports, use CSV Import or run multiple queries with different filters.
  </Accordion>

  <Accordion title="Can I schedule automated exports?">
    Not currently. Scheduled exports are planned for a future release.
  </Accordion>

  <Accordion title="Can I export files to cloud storage (Google Drive, Dropbox, etc.)?">
    Not yet. Cloud storage integrations are planned for future releases. Currently, files export to your local computer only.
  </Accordion>

  <Accordion title="Does FileFetch support OAuth 2.0 login?">
    Not currently. FileFetch uses username/password/security token authentication. OAuth 2.0 support is planned for a future release.
  </Accordion>
</AccordionGroup>

## Technical Questions

<AccordionGroup>
  <Accordion title="What Salesforce API does FileFetch use?">
    FileFetch uses the Salesforce SOAP API for authentication and REST API for file downloads. This provides the best performance and reliability for bulk file exports.
  </Accordion>

  <Accordion title="Does FileFetch count against my Salesforce API limits?">
    Yes. Each query and file download counts as an API call. However, FileFetch is designed to be efficient:

    * Batches requests to minimize API calls
    * Uses concurrent downloads for speed
    * Respects Salesforce rate limits

    Most Salesforce orgs have generous API limits (15,000-100,000+ calls per 24 hours).
  </Accordion>

  <Accordion title="How fast are downloads?">
    Download speed depends on:

    * Your internet connection
    * File sizes
    * Concurrent download setting (1-10 simultaneous downloads)
    * Salesforce API rate limits

    Typical performance: \~1000 files in 5-10 minutes with 10 concurrent downloads.
  </Accordion>

  <Accordion title="Can I export custom fields or metadata?">
    FileFetch exports the file content itself. Metadata (Title, Created Date, Size, etc.) is saved in the Export Summary. Custom field export is not currently supported but may be added in future releases.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="I can't log in - what should I do?">
    See the [Authentication Guide](/authentication) and [Troubleshooting](/troubleshooting#authentication-issues) for detailed login help.

    Common issues:

    * Verify username, password, and security token are correct
    * Check you selected the right environment (Production/Sandbox/Custom)
    * Ensure your user has API access enabled
  </Accordion>

  <Accordion title="My query returns no results - why?">
    Common reasons:

    * Filters are too restrictive (try broadening date range)
    * No files match your criteria in Salesforce
    * You don't have permission to view the files
    * Wrong Export Type selected (Files vs Attachments)

    See [Troubleshooting - Query Issues](/troubleshooting#query-issues).
  </Accordion>

  <Accordion title="Some files failed to download - what happened?">
    Check the Export Summary (`_Export_Summary.txt`) for specific error messages.

    Common causes:

    * Download timeout (increase timeout in Settings)
    * Network interruption (retry the export)
    * File was deleted from Salesforce
    * Insufficient permissions

    You can retry failed downloads from [Export History](/export-history) (coming soon).
  </Accordion>
</AccordionGroup>

## Privacy & Security

<AccordionGroup>
  <Accordion title="Is FileFetch secure?">
    Yes. FileFetch is built with security as a top priority:

    * Credentials stored in OS-level secure keychain
    * Direct connection to Salesforce (no middleman)
    * No data sent to FileFetch servers
    * Files stay on your local computer
    * Code-signed application
  </Accordion>

  <Accordion title="Can I use FileFetch with sensitive/confidential data?">
    Yes. Since all data stays local and FileFetch connects directly to Salesforce, it's suitable for confidential data. However, always follow your organization's data handling policies.
  </Accordion>

  <Accordion title="Does FileFetch log my activity?">
    FileFetch keeps local logs for troubleshooting (export history, error logs). These logs never leave your computer. You can delete them by uninstalling the app.
  </Accordion>
</AccordionGroup>

## Pricing & Licensing

<AccordionGroup>
  <Accordion title="How does the free trial work?">
    FileFetch offers a 14-day free trial with full features. No credit card required.
  </Accordion>

  <Accordion title="What happens after the trial ends?">
    You'll need to purchase a license to continue using FileFetch. Visit [filefetch.app/pricing](https://filefetch.app/pricing) for pricing options.
  </Accordion>

  <Accordion title="Is there a team/enterprise license?">
    Yes. Contact [sales@filefetch.app](mailto:sales@filefetch.app) for team and enterprise pricing.
  </Accordion>
</AccordionGroup>

## Still Have Questions?

<CardGroup cols={2}>
  <Card title="Contact Support" icon="envelope" href="mailto:support@filefetch.app">
    Email us with any questions
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/troubleshooting">
    Common issues and solutions
  </Card>

  <Card title="Quick Start Guide" icon="rocket" href="/quickstart">
    Learn FileFetch in 5 minutes
  </Card>

  <Card title="Documentation" icon="book" href="/">
    Browse full documentation
  </Card>
</CardGroup>