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

# Overview

> Upload, organize, and serve images, videos, documents, and other files used in your Archie app from a centralized media surface.

The Assets surface is where you store and manage files used in your app — images, videos, documents, fonts, and other media. Files are served from the [file storage provider](/features/backend/app-services/file-manager) configured in your project.

## What you can do

* **Upload** files individually or in bulk
* **Browse** assets with search and filters
* **Preview** images, videos, and documents in place
* **Copy URLs** for use in code or pages
* **Delete** assets, with confirmation
* **Organize** assets with folders and tags

## Uploading

Click **Upload** in the Assets surface or drag and drop files into the browser. Archie processes the upload, stores the file in your configured provider (S3, Google Cloud Storage, Azure Blob, Filestack), and adds it to the asset index.

For large files or batches, the upload runs in the background and the asset appears once processing completes. You can keep working while uploads run.

## Using assets in your app

Once uploaded, an asset has a URL you can reference from anywhere:

* **The [visual editor](/features/frontend/visual-editor)** — replace an image element by selecting and uploading
* **Frontend code** — paste the URL into an `<img>` or `Image` component
* **[Custom functions](/features/backend/custom-functions/overview)** — fetch the asset server-side
* **Generated email templates** — reference assets by URL

Asset URLs are stable. Re-uploading a file with the same name produces the same URL by default, so existing references keep working.

## Storage providers

Files are stored in the file storage provider configured for your project. Archie supports:

* **AWS S3** — default for most projects
* **Google Cloud Storage**
* **Azure Blob Storage**
* **Filestack**

Each provider integrates with a CDN, so assets are served fast worldwide. Switch providers in [App services → File manager](/features/backend/app-services/file-manager).

## Limits

Limits depend on your plan and the provider's quotas:

* **Starter backend** — 1 GB included, \$0.021/GB/mo overage, 25 GB max
* **Professional backend** — 10 GB included, same overage rate, 250 GB max
* **Enterprise** — custom

See [plans and credits](/introduction/getting-started/plans-and-credits) for the full breakdown.

## FAQ

<AccordionGroup>
  <Accordion title="What file types are supported?">
    Images (PNG, JPG, GIF, SVG, WebP), video (MP4, WebM), audio (MP3, WAV, AAC), PDF, and common document formats. Type restrictions are configurable per project.
  </Accordion>

  <Accordion title="Are assets served via CDN?">
    Yes. Each storage provider integrates with a global CDN (CloudFront for S3, Cloud CDN for GCS, Azure CDN for Blob). Asset URLs are CDN URLs — no extra setup needed.
  </Accordion>

  <Accordion title="Can I bulk-upload via API?">
    Yes. The asset upload API is available through the [REST API](/features/backend/rest-api-explorer/overview) and the typed client. Authenticate with an [API key](/features/backend/settings/api-keys).
  </Accordion>

  <Accordion title="What happens to URLs when I delete an asset?">
    URLs return 404 immediately. References in your code or pages should be updated before deletion. The asset history shows deleted assets for 30 days, after which the file is permanently removed.
  </Accordion>
</AccordionGroup>