Skip to main content
Fileloom integrates with external storage providers, giving you flexibility in where your generated PDFs are stored.

​
Why External Storage?

By default, Fileloom stores generated PDFs in Firebase Storage with permanent public URLs. External storage lets you:
  • Keep PDFs in your infrastructure — Meet compliance and data residency requirements
  • Integrate with existing workflows — Use your current storage systems
  • Control access — Manage permissions with your own policies
  • Reduce costs — Leverage existing storage allocations

​
Supported Providers

AWS S3

Store PDFs in Amazon S3 buckets with full control over regions, paths, and permissions

Supabase Storage

S3-compatible storage integrated with your Supabase project

​
Setting Up Storage Integrations

1

Open Workspace Settings

Click the settings icon in your workspace sidebar to open Workspace Settings.
2

Go to Integrations

Select Integrations from the left menu. You’ll see the Storage Integrations section with all supported providers.
3

Connect a Provider

Find the storage provider you want to use (Amazon S3 or Supabase Storage) and click the Connect button.
4

Enter Credentials

Fill out the connection form with your provider credentials (bucket name, access keys, region, etc.).
5

Automatic Connection Test

Click Connect to save. Fileloom automatically runs a connection test to verify your credentials and permissions.
6

Connection Enabled

If the test passes, your connection is approved and enabled. You’ll see a Connected badge next to the provider.

​
Storage Mode Settings

Once you have at least one connection, you can configure how Fileloom handles PDF storage. In the Settings section below your connections, choose your preferred Save on mode:
ModeFileloom StorageExternal StorageBest For
Fileloom✅❌Simple setup, getting started
External❌✅Compliance, existing infrastructure
Both✅✅Redundancy, migration period

​
Mode Behaviors

Fileloom Mode (Default)
  • PDFs stored in Firebase Storage
  • Permanent public URLs
  • 24-hour signed URLs for secure access
  • No external configuration needed
External Mode
  • PDFs stored only in your connected external provider
  • URLs from your storage provider
  • If external upload fails, falls back to Fileloom to prevent data loss
Both Mode
  • PDFs stored in Fileloom AND external provider
  • Primary URL from Fileloom
  • External copies listed in API response
  • Best for gradual migration or backup

​
Managing Connections

After connecting a provider, you can manage it from the Integrations page:
  • Primary — If you have multiple connections, one is marked as Primary and used first
  • Connected / Inactive — Shows the current status of each connection
  • Actions menu (⋮) — Edit credentials, run connection test, or disconnect

​
Connection Status

StatusDescription
ConnectedWorking normally, ready to receive files
InactiveConnection disabled or credentials invalid

​
Path Patterns

Customize how files are organized in your external storage using path pattern variables:
VariableDescriptionExample
{year}Current year2024
{month}Current month (01-12)12
{day}Current day (01-31)15
{workspace}Workspace IDws_abc123
{template}Template IDtpl_xyz789
{filename}Generated filenameinvoice-001.pdf
{fileid}Unique file IDfile_abc123
Example Patterns: 
pdfs/{year}/{month}/{filename}
→ pdfs/2024/12/invoice-001.pdf

{workspace}/{year}-{month}-{day}/{filename}
→ ws_abc123/2024-12-15/invoice-001.pdf

invoices/{template}/{fileid}.pdf
→ invoices/tpl_invoice_v2/file_abc123.pdf

​
API Response

When external storage is configured, the API response includes external copy information:
Response
{
  "success": true,
  "data": {
    "fileId": "file_abc123",
    "url": "https://storage.googleapis.com/...",
    "storageProvider": "firebase",
    "externalCopies": [
      {
        "provider": "s3",
        "name": "Production S3",
        "url": "https://my-bucket.s3.amazonaws.com/pdfs/2024/12/invoice.pdf",
        "expiresAt": "2024-12-16T10:30:00Z"
      }
    ]
  }
}

​
Plan Availability

External storage integrations are available on all plans.
FeatureFreeStarterGrowthScale+
External Storage✅✅✅✅
Multiple Connections❌❌✅✅

​
Next Steps

AWS S3 Setup

Step-by-step guide for Amazon S3

Supabase Setup

Step-by-step guide for Supabase Storage