Documentation
Everything you need to know about File To Site — from uploading your first file to advanced developer features.
๐ 1. Getting Started
Turn any file into a website in under 30 seconds. No account required.
1
UploadDrag & drop any file — Markdown, PDF, CSV, images, code, and more
2
CustomizePick a template, give your site a title, set a custom slug
3
ShareGet a live link and a short v.gd URL instantly
๐ Supported Formats (50+)
We support virtually every file type:
- Documents: .md, .txt, .pdf, .docx, .pptx, .xlsx, .rtf, .odt, .ods, .tex
- Data: .csv, .json, .xml, .yaml, .toml
- Web: .html, .svg, .css
- Images: .png, .jpg, .gif, .webp, .bmp, .ico
- Audio: .mp3, .wav, .ogg, .flac, .aac
- Video: .mp4, .webm, .mov
- Code: .py, .js, .ts, .go, .rs, .java, .c, .cpp, .rb, .php, .swift
- Archives: .zip, .tar.gz (auto-extracted into hosted sites)
๐จ 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
- Without login: Upload files and get a live site instantly. Anonymous uploads are public by default.
- With login: Edit sites later, manage from the dashboard, set privacy controls, use the API, get analytics, and more.
โ
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:
- Smart Merge: New files are added, existing files are updated, old files are kept.
- Replace All: Completely replaces all files with the new upload.
- Add Only: Only adds new files without touching existing ones.
โ๏ธ 5. In-Browser Editing
Edit files directly from the browser — no downloads or re-uploads required.
Supported edit types:
- Text Files: .txt, .md, .csv — full text editor with live preview
- HTML: Edit source code and see the rendered result instantly
- JSON: Tree editor with validation — catches syntax errors before saving
- Code: Syntax-highlighted editor for any programming language
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.
- ๐ Like — bookmark-style appreciation
- ๐ฅ Popular — mark trending content
- ๐ Dislike — downvote low-quality 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:
- HTML / CSS / JS templates
- Markdown documentation
- Data files (CSV, JSON) you want to remix
- Code snippets and starter projects
๐ 8. File Collections
Group related files into shareable collections — like playlists for your content.
- Create named collections: “My PDFs”, “Project Assets”, “Course Materials”
- Drag files in/out of collections from the dashboard
- Share the entire collection with a single link
- Collections get their own page with file listing and download-all option
๐ 9. File Dependencies
Link related files together for multi-file projects.
When you upload multiple files, dependencies are detected automatically:
- HTML → CSS → JS: Web projects render correctly with all assets linked
- Markdown + Images: Image references resolve automatically
- ZIP uploads: Internal file references are preserved
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.
๐ก 11. Direct Download API Links
Get programmable links to any hosted file.
For every file, you get three link types:
- Raw link: Serves the file with its original content type (inline display)
- Forced download link: Triggers browser download dialog
- Preview link: Opens the styled viewer page
Raw: /s/my-site/raw/file.pdf
Download: /s/my-site/dl/file.pdf
Preview: /s/my-site
๐ฒ 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.
- Link works for a single download — then self-destructs
- Combine with expiring links for double protection
- Perfect for sensitive documents, paid content, or limited distribution
Send a contract as a one-time link — recipient downloads once, link dies.
๐งพ 14. Watermark System
Protect images and PDFs with automatic watermarks.
- Images: Overlay text watermark (username, custom text, timestamp)
- PDFs: Add diagonal watermark text across pages
- Watermarks are applied on-the-fly — original file stays clean
๐ซ 15. Hotlink Protection
Prevent other sites from embedding or linking directly to your files and stealing your bandwidth.
Enable in the Editor under Security settings. When active, requests from unauthorized domains are blocked. Only your site and approved referrers can serve the content.
๐ง 16. File Story Mode
Turn your file page into a narrative — like a blog post wrapped around your file.
Attach to any file:
- A rich description / story
- Update logs (changelog-style)
- Context about the file's purpose
“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:
- Text blocks (headings, paragraphs, rich text)
- Call-to-action buttons
- External links
- Image banners
- Custom background & colors
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
๐ 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.
- Set expiry: 1 hour, 24 hours, 7 days, 30 days
- File and site page auto-delete when the time is up
- No account needed for temp uploads
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.
- Most Viewed: All-time most popular files
- Trending Today: Files gaining traction right now
- Top Rated: Files with the most positive reactions
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:
- Accent color: Pick from 8 presets or enter a custom hex
- Font family: Use any Google Font or system font
- Theme: Dark, Light, or Auto
- Layout: Simple, Unified, or Presentation
- Custom CSS: Write your own styles for full control
- Background: Set a background color or gradient
- Description & buttons: Add context and CTAs via Page Builder
๐ 23. File Search
Find files across the entire platform or within your dashboard.
- Search by filename, title, description, or tags
- Filter by file type, template, date range
- Dashboard search filters your own sites in real-time
- Explore search covers all public sites
๐งน 25. Auto File Optimization
Files are automatically optimized for web delivery.
- Images: Compressed with quality preservation, converted to WebP when beneficial
- Video: Transcoded for streaming compatibility
- Documents: Minified HTML/CSS/JS, optimized PDF rendering
- Original files are always preserved — optimization applies only to the served version
๐ 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
๐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 ZIPDrag your .zip containing HTML, CSS, JS, images
2
Auto-ExtractAll files are extracted and organized
3
Live URLYour 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:
- Thumbnail preview
- Title & description
- File preview / download button
- View count & reactions
- Open Graph & Twitter Card meta tags for rich social previews
“This file has been viewed 10,000 times” — social proof built in.
๐ฐ 29. Custom Domains
Connect your own domain or subdomain to any site.
- Add a CNAME record pointing to
filetosite.com
- SSL certificates are provisioned automatically
- Works with any registrar (Namecheap, GoDaddy, Cloudflare, etc.)
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.