> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wifipadi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Portal ads

> Show your own promotions, or a sponsor's, on the screens your guests already look at.

Every guest who buys WiFi looks at four screens on the way through. You can put an image on any of them — your own promotion, or one you sold to a local business.

Go to **Portal Ads**. Manager role or higher.

## The four placements

| Placement                       | When the guest sees it                                                              |
| ------------------------------- | ----------------------------------------------------------------------------------- |
| **Login / signup**              | Before they have an account. Everyone who connects, including people who never buy. |
| **Plan picker**                 | While they are choosing what to buy.                                                |
| **Connected / payment success** | Straight after they pay, at the happiest moment in the flow.                        |
| **Customer account**            | Whenever they come back to check their data. Repeat viewers.                        |

Each placement takes one active image at a time.

## Uploading

<Steps>
  <Step title="Choose the placement">
    One image per placement.
  </Step>

  <Step title="Upload the image">
    JPEG, PNG, GIF or WebP, up to 400 KB.
  </Step>

  <Step title="Add a mobile version (recommended)">
    Optionally upload a second, phone-shaped crop. Almost all of your guests are on a phone. Without it, the desktop image is used on both.
  </Step>

  <Step title="Add a link and alt text">
    The link is where a tap goes. Alt text describes the image for anyone who cannot see it.
  </Step>
</Steps>

<Warning>
  **Keep the file small.** These render on a captive portal over the same data your guest just paid for. A 400 KB creative on a 100 MB plan spends four-tenths of a percent of what they bought before they have loaded a single page of their own.

  This is why 400 KB is a hard limit rather than a suggestion, and why SVG files are not accepted at all.
</Warning>

## If you are linking somewhere

A guest sitting on the login screen has not paid yet, so their device can only reach the small set of sites your gateway allows before payment. A link to somewhere outside that set will not open for them.

Links are safest on the **connected** and **account** placements, where the guest already has working internet.

## Measuring

Each ad records impressions and clicks, charted per day. That is the number to put in front of a local business you are selling the slot to.

Use the toggle to take an ad down without deleting it, so its history survives.