How storage works
The agent writes the code to handle file uploads and storage as part of your website. When your app needs to store files (profile photos, document uploads, product images), the agent sets up the upload endpoints and storage logic. Your storage bucket is private by default. Files are served through your website’s backend, which controls access.When to use storage
- User-uploaded profile pictures or avatars.
- Document uploads (PDFs, spreadsheets, images).
- Product images for an e-commerce site.
- Media assets that your application serves dynamically.
- Any file that users upload through your website.
What you cannot do
- You cannot browse stored files from the Runable dashboard. Files are managed through your website’s code.
- You cannot connect an external storage provider (S3, Google Cloud Storage) in place of R2.
- You cannot set storage size limits from the dashboard. The agent handles this in code.
- You cannot create multiple storage buckets for the same website. Each website gets one bucket.

.png?fit=max&auto=format&n=J3TfNmZhqEoKcaaO&q=85&s=468b5adb026aa33181cc81ab54ab68db)