Fallback Pages
What is a Fallback Page?
A Fallback Page is a static website that receives traffic that did not match the filters of any stream set in the campaign, as well as clicks blocked by Adset Protect. It can be any site of yours: a blog, a store, a corporate page, etc.
1. Requirements for a Fallback Page
1.1 Archive Format
A Fallback Page is uploaded as a ZIP archive with the following requirements:
Maximum archive size: 10 MB
At the root of the archive there must be a file
index.htmlThe archive may contain nested folders with resources (CSS, JS, images, fonts, etc.)
Correct ZIP structure:
my-fallback-page.zip
├── index.html ← must be at the root
├── css/
│ └── style.css
├── js/
│ └── main.js
└── images/
├── logo.png
└── banner.jpg
Incorrect structure (index.html inside a subfolder):
my-fallback-page.zip
└── my-site/ ← ✗ cannot be nested in a folder
├── index.html
└── css/
└── style.css
1.2 Fully Static Content
A Fallback Page must be a fully static site:
✅ HTML, CSS, JavaScript, images, fonts
✅ Inline styles and inline scripts
❌ Server-side scripts (PHP, Python, Node.js, etc.)
❌ Dynamic API requests to external servers (the page must work without a server side)
❌ Linking to external resources from suspicious domains
1.3 Only Relative URLs
This is the most important rule. All links to resources (CSS, JS, images, fonts) within the Fallback Page must be relative.
✅Correct — relative paths:
<link rel="stylesheet" href="css/style.css">
<script src="js/main.js"></script>
<img src="images/logo.png" alt="Logo">
/* In CSS files, relative paths too */
background-image: url('../images/bg.jpg');
@font-face {
src: url('../fonts/roboto.woff2');
}
❌Incorrect — absolute paths:
<!-- ✗ Absolute path -->
<link rel="stylesheet" href="/css/style.css">
<script src="/js/main.js"></script>
<img src="/images/logo.png" alt="Logo">
<!-- ✗ Full URL to your own files -->
<link rel="stylesheet" href="https://my-server.com/css/style.css">
Why? Relative paths work correctly on any campaign domain where the Fallback Page is published.
1.4 Allowed External Resources
Linking to popular external libraries via CDN is allowed:
<!-- ✅ Google Fonts -->
<link href="https://fonts.googleapis.com/css2?family=Roboto&display=swap" rel="stylesheet">
<!-- ✅ Bootstrap, jQuery, and other popular CDNs -->
<link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" rel="stylesheet">
2. Creating a Fallback Page
Go to the PWA → Fallback Pages section
Click the "Add" button
Fill in the fields:
Name — a clear name (e.g., "Cooking Blog")
Active — activity status
ZIP archive — upload the prepared ZIP archive
Click "Save"
After saving, the archive will be automatically unpacked and uploaded to the CDN. The status will change to Ready after successful processing.
3. Editing HTML
You can edit the content of index.html directly in the browser:
In the Fallback Pages table, click ⋮ (action menu) next to the desired entry
Select "Edit HTML"
An editor with two panels will open:
On the left — code editor with syntax highlighting
On the right — live preview of the page
Make changes to the HTML
Click "Save" to save
Keyboard Shortcuts in the Editor
Key | Action |
|---|---|
| Add indentation (2 spaces) |
| Remove indentation |
| New line while preserving indentation |
4. Viewing on CDN
To view the published Fallback Page:
Click ⋮ → "Open CDN"
The page will open in a new tab
5. Using in Campaigns
When creating or editing a campaign in the Tracker → Campaigns section:
In the Fallback Page field, select the desired page from the dropdown list
The list displays:
Fallback Pages of your team
System Fallback Pages (marked as "System") — available to all teams
6. Fallback Page Statuses
Status | Description |
|---|---|
Ready | The page is unpacked and available on the CDN |
Uploading | The archive is uploading |
Processing | The archive is unpacking |
Error | Error processing the archive |
After upload, the status updates automatically — wait for Ready (or Error), there is no need to refresh the page. If the status is Error, click it to see the reason.
7. Common Errors
Page displays without styles/images
Reason: Absolute paths are used instead of relative ones. Solution: Replace all /css/..., /js/..., /images/... with css/..., js/..., images/... (without leading /).
Error uploading archive
Reason: The file index.html is not at the root of the archive. Solution: Ensure that when creating the ZIP, the file index.html is at the top level, not inside a subfolder.
Status "Error" after upload
When the status is Error, click it to see the reason. Then rebuild the archive following the rules in section 1 (size up to 10 MB, index.html at the root, relative paths). If the error persists, contact support.
