Skip to content

Uploading Overlays

You can import an overlay from a ZIP file using the Upload Overlay feature. This is useful for restoring backups or sharing overlays between users.

ZIP Requirements

To upload an overlay successfully:

  • The ZIP file must contain one top-level folder
  • That folder should include your overlay files (e.g. index.html, script.js, style.css, assets/, etc.)
  • Total upload size must be under 500MB

❌ Invalid:

shoutout_1.zip
├── index.html
├── script.js

✅ Valid:

shoutout_1.zip
└── shoutout/
    ├── index.html
    ├── script.js
    ├── style.css
    └── assets/

How to Upload

  1. Navigate to The Forge
  2. Click Upload Overlay (ZIP)
  3. Select the user to upload for (if you have admin access)
  4. Drag and drop your .zip file into the upload box, or click to browse
  5. Wait for the upload and validation to complete

You’ll be redirected to the overlay's view page once it’s successfully imported.

When to Use

  • Restoring an exported overlay
  • Transferring overlays between environments or accounts
  • Importing overlays built by collaborators