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

# Captive promo banners

> Create scheduled image, video, or link placements on the Hotspot captive portal.

# Promote offers on the captive portal

Open **Communications → Promo banners**. These campaigns render promotional placements on captive pages and track impressions/views and clicks. They do not send SMS/email.

## Creative fields

* **Name:** required, maximum 120; internal reporting label.
* **Type:** current campaign type option.
* **Placement:** where the creative appears.
* **Destination/media URL:** optional, maximum 500; meaning depends on type.
* **Media upload:** optional; uploaded file takes precedence over URL.
* **Display size:** small, medium, or large for media.
* **Start/end:** optional; blank start begins now and blank end runs indefinitely.

Supported media:

* images: PNG, JPEG, SVG, WEBP up to 2 MB;
* video: MP4, WEBM up to 10 MB.

End must be on or after start.

## Create a campaign

1. Choose a clear internal name.
2. Select type and placement.
3. For a link/banner, use a destination reachable by captive users.
4. For image/video, upload sanitized optimized media or use a trusted HTTPS URL.
5. Choose display size and preview on mobile/desktop captive layouts.
6. Set a deliberate run window.
7. Save and test from a real captive network.

## Walled-garden considerations

A destination or hosted media URL may be unreachable before authentication unless the router allows it. Prefer controlled domains, keep the allowlist narrow, and test without using an already authenticated browser session.

## Performance

Views and clicks allow a click-through-rate calculation. They measure portal interaction, not completed purchase or revenue unless another analytics path links the outcome. Compare campaigns with similar audience/window before drawing conclusions.

## Remove media

The edit form's Remove action persists deletion of the saved creative. After removal, save the campaign and confirm the portal no longer renders the old cached asset.