Documentation

Everything you need to know about File To Site — from uploading your first file to advanced developer features.

Table of Contents

๐Ÿš€ 1. Getting Started

Turn any file into a website in under 30 seconds. No account required.

1
Upload

Drag & drop any file — Markdown, PDF, CSV, images, code, and more

2
Customize

Pick a template, give your site a title, set a custom slug

3
Share

Get a live link and a short v.gd URL instantly

๐Ÿ“‚ Supported Formats (50+)

We support virtually every file type:

๐ŸŽจ 27+ Templates

Choose from Blog, Docs, Gallery, Portfolio, Resume, Slides, Wiki, Landing Page, Magazine, Changelog, API Docs, Tutorial, Recipe, Timeline, FAQ, Comparison, Product, Newsletter, Journal, Music Player, Video Gallery, File Hub, Dashboard Report, Knowledge Base, Book, Presentation, and more.

๐Ÿ‘ค Account vs. No Account

โœ… 2. Smart File Viewer

Every file gets the perfect viewer, automatically detected by type.

๐Ÿ“„
PDFInline viewer with page navigation
๐ŸŽฌ
MP4 / WebMFull video player with controls
๐ŸŽต
MP3 / WAVAudio player with waveform
๐ŸŒ
HTMLRendered as a live website
๐Ÿ“
Markdown / TXTRich formatted preview
๐Ÿ’ป
Code FilesSyntax highlighting (like GitHub)
๐Ÿ–ผ๏ธ
ImagesGallery view with zoom
๐Ÿ“Š
CSV / JSON / XMLInteractive data tables & tree view

๐Ÿงญ 3. Smart Access Rules

Fine-grained control over who can access and download your files.

๐ŸŒ Country-Based Access

Restrict downloads to specific countries using Geo-IP detection. Ideal for region-locked content or compliance requirements.

Only allow downloads from the US, UK, and Canada.

โฐ Time-Based Access

Set time windows when files are accessible. Perfect for scheduled releases, limited-time content, or classroom assignments.

File accessible only Monday–Friday, 9 AM–5 PM EST.

โฑ๏ธ Delayed Downloads

Require visitors to stay on the page for a minimum time before the download button activates. Great for engagement or ad-supported models.

“User must stay 10 seconds before download unlocks.”

๐Ÿ”’ Password Protection

Set a password on any site. Visitors see a password prompt before content loads.

๐ŸŽŸ๏ธ Token-Based URLs

Generate signed URLs that only work for specific users or for a limited time. Perfect for paid content or private sharing.

โณ Expiring Links

Links automatically expire after a set duration. Combine with one-time download links for maximum security.

๐Ÿ” 4. Auto-Update Files (Live Sync)

Upload once, keep your hosted file updated automatically when the source changes.

๐Ÿ™ GitHub Repo Sync

Connect a GitHub repository. When you push changes, your hosted site updates automatically via webhook.

How it works: Link your repo → Set the file path (e.g. docs/README.md) → Enable auto-sync → Every push triggers an update.

๐Ÿ”— URL Sync

Point to any public URL. File To Site periodically fetches the latest version and updates your hosted page.

Sync from https://example.com/data.json — your site always shows the latest data.

๐Ÿ“ค Manual Re-Upload

Use the Editor's file section to re-upload with three modes:

โœ๏ธ 5. In-Browser Editing

Edit files directly from the browser — no downloads or re-uploads required.

Supported edit types:

Hit Save and the hosted version updates immediately. Version history tracks every change.

โญ 6. File Reactions

Let your audience react to files — like social media for hosted content.

Files can be sorted by reaction count on the Explore page. Reactions help surface the best content.

๐Ÿงฌ 7. File Forking

Copy and modify anyone's public file — like GitHub forking, but for any file type.

Click “Fork this file” on any public site to get your own copy. Modify it freely without affecting the original.

Fork an HTML template, customize the design, publish as your own site — all in seconds.

Especially powerful for:

๐Ÿ“š 8. File Collections

Group related files into shareable collections — like playlists for your content.

๐Ÿ”— 9. File Dependencies

Link related files together for multi-file projects.

When you upload multiple files, dependencies are detected automatically:

Upload index.html + style.css + app.js → full website with all assets working.

๐Ÿš€ 10. Multi-CDN Delivery

Toggle between delivery modes for speed or control.

โšก
Fast (CDN)Served via Cloudflare's global edge network. Fastest for most users.
๐ŸŽฏ
Direct (Origin)Served from R2 origin. Useful for debugging or bypass scenarios.

Default is CDN mode. Switch in the Editor under advanced settings.

๐Ÿ“ฒ 12. QR Code Generator

Auto-generated QR code for every file — instant mobile sharing.

Every published site gets a QR code that links directly to it. Download the QR as PNG or SVG for print materials, presentations, or product packaging.

๐Ÿ”‘ 13. One-Time Download Links

Generate links that work exactly once, then expire permanently.

Send a contract as a one-time link — recipient downloads once, link dies.

๐Ÿงพ 14. Watermark System

Protect images and PDFs with automatic watermarks.

๐Ÿง  16. File Story Mode

Turn your file page into a narrative — like a blog post wrapped around your file.

Attach to any file:

“This dataset shows US population growth from 1900–2024. Updated monthly from Census.gov.”

Makes files feel like social media posts — discoverable, engaging, and shareable.

๐Ÿ•’ 17. Time Capsule Files

Upload now, unlock later. Schedule files for future release.

Set a release date when uploading. The file page shows a countdown timer. When the date arrives, content becomes accessible.

Upload exam answers → set unlock date to after the exam → students can't peek early.

๐Ÿงฑ 18. Page Builder for Files

Turn any file page into a mini landing page with blocks, buttons, and links.

Add around your file:

Basically: file + landing page = combined. Perfect for product launches, portfolio pieces, or marketing assets.

๐Ÿงฌ 19. Developer API

Full REST API for programmatic uploads and site management.

๐Ÿ”‘ Authentication

Get your API key from the Dashboard. Include it as a header:

Authorization: Bearer YOUR_API_KEY

๐Ÿ“ค Upload via API

POST /api/sites — multipart/form-data with files, title, template, slug

Response includes the live URL and short URL.

๐Ÿ“‹ List Sites

GET /api/sites — Returns all your sites with metadata

โœ๏ธ Update Site

PUT /api/sites/:id — JSON body with updated fields

๐Ÿ—‘๏ธ Delete Site

DELETE /api/sites/:id

๐Ÿ“ Re-Upload Files

POST /api/sites/:id/reupload — multipart/form-data, supports mode: smart | replace | add

๐Ÿงพ 20. Temporary File Hosting

Like temp mail, but for files. Auto-deletes after a set time.

Share a large file for 24 hours — link dies automatically after.

๐Ÿ“Š 21. Top Files & Trending

Discover the most popular and trending content on the platform.

Browse via the Explore page. Filter by file type, template, or tag.

๐ŸŽจ 22. File Page Customization

Make every site page truly yours.

In the Editor, customize:

๐Ÿท๏ธ 24. Tags & Categories

Organize content with tags for discoverability.

๐Ÿงน 25. Auto File Optimization

Files are automatically optimized for web delivery.

๐Ÿ” 26. Security & Trust

Security is foundational — not an afterthought.

๐Ÿ›ก๏ธ
Virus ScanningUploaded files are scanned for malware
๐Ÿ“‹
File Type RestrictionsBlocked: .exe, .bat, .scr, .msi, etc.
โšก
Rate LimitingUpload & API rate limits prevent abuse
๐Ÿšฉ
Abuse ReportingReport button on every public page
โš–๏ธ
DMCA SystemFull DMCA takedown process
๐Ÿ”’
HTTPS EverywhereAll traffic encrypted via TLS

๐Ÿ“ฆ 27. ZIP → Website Mode

Upload a ZIP file and it becomes a fully hosted website. This is huge.

1
Upload ZIP

Drag your .zip containing HTML, CSS, JS, images

2
Auto-Extract

All files are extracted and organized

3
Live URL

Your site is live immediately with all assets

Export from VS Code, Figma, or any tool → ZIP → Upload → Live website in 5 seconds.

๐Ÿš€ 28. Share Page Generator

Auto-generated beautiful share pages for every site.

Every file gets a share page with:

“This file has been viewed 10,000 times” — social proof built in.

๐Ÿ’ฐ 29. Custom Domains

Connect your own domain or subdomain to any site.

docs.example.com → Your File To Site page

๐Ÿ”— 30. Custom Slugs & Short URLs

Choose your own URL and get an auto-shortened link.

โœ๏ธ Custom Slugs

When uploading, set a custom slug to get a clean, memorable URL:

filetosite.com/s/my-portfolio instead of filetosite.com/s/a8f3k2x

๐Ÿ”— Auto Short URLs

Every site automatically gets a v.gd short URL for easy sharing:

v.gd/MyPortfolio → redirects to your full site URL

Both URLs are shown after upload and in the dashboard.