Adset.ProAdset.ProKnowledge base
To app
Home/PWA (Landing Pages)/Fallback Pages

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.html

  • The 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

  1. Go to the PWA → Fallback Pages section

  2. Click the "Add" button

  3. Fill in the fields:

    • Name — a clear name (e.g., "Cooking Blog")

    • Active — activity status

    • ZIP archive — upload the prepared ZIP archive

  4. 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:

  1. In the Fallback Pages table, click ⋮ (action menu) next to the desired entry

  2. Select "Edit HTML"

  3. An editor with two panels will open:

    • On the left — code editor with syntax highlighting

    • On the right — live preview of the page

  4. Make changes to the HTML

  5. Click "Save" to save

Keyboard Shortcuts in the Editor

Key

Action

Tab

Add indentation (2 spaces)

Shift + Tab

Remove indentation

Enter

New line while preserving indentation


4. Viewing on CDN

To view the published Fallback Page:

  1. Click ⋮ → "Open CDN"

  2. The page will open in a new tab


5. Using in Campaigns

When creating or editing a campaign in the Tracker → Campaigns section:

  1. In the Fallback Page field, select the desired page from the dropdown list

  2. 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.