Appearance
Settings Reference
Everything lives under Settings → Voxel Ads, across five tabs: Settings, Cross-Feed Promotion, AI Banner, License, and the Maintenance tools at the bottom of the Settings tab.
General
| Setting | Default | What it does |
|---|---|---|
| Voxel CPT key | ad-banner | The post type advertisers submit banners through. |
| Desktop image field key | desktop-banner | Voxel field holding the leaderboard creative. |
| Mobile image field key | mobile-banner | Voxel field holding the rectangle creative. Optional. |
| Destination URL field key | destination-url | Voxel URL field for the click-through. |
| Default duration (days) | 84 | Used only when a banner has no listing plan. |
| Never-expire sentinel year | 2099 | Stop year for plans with no expiry. Must be in the future. |
| Stats cache TTL | 300 | Seconds to cache stats and schedule reads. 0 disables caching. |
Field keys are the usual culprit
If banners sync but arrive with no image or no link, the field keys here don't match the Voxel post type. Check them character for character.
Plan → Group mapping
| Setting | What it does |
|---|---|
| Plan → Group mapping | One plan_key=group_id per line. # starts a comment. |
| Fallback group ID | Catches banners whose plan isn't mapped. 0 means no group — and no group means the banner is never selected by a group placement. |
Statistics
| Setting | Default | What it does |
|---|---|---|
| Reset on relist | Off | Archive stats automatically when a banner is relisted under a new order. |
Notifications
| Setting | Default | What it does |
|---|---|---|
| Milestone notifications | On | Email the author when a banner crosses a threshold. |
| Milestone thresholds | 100, 500, 1000, 5000, 10000 | Comma-separated. Each fires once per stat type per banner. |
| Expiry warning | On | Email the author before their plan expires. |
| Warning days | 3 | How many days ahead to warn. |
Pricing
| Setting | Default | What it does |
|---|---|---|
| Plan → Price mapping | Empty | Fallback prices for banners with no Voxel order. One plan_key=price per line. |
| Currency symbol | $ | Used for manually-priced banners. |
Prices come from Voxel order items automatically — these are fallbacks only.
Deletion behaviour
| Setting | Default | What it does |
|---|---|---|
| Cascade delete | Off | Off: deleting a banner post marks the AdRotate advert disabled, preserving history. On: hard-deletes the advert, schedule, linkmeta and statistics. |
Cascade delete is irreversible
With it on, deleting a banner post destroys its statistics permanently. Leave it off unless you have a specific reason — disabled adverts cost nothing to keep.
Feed injection
| Setting | Default | What it does |
|---|---|---|
| Enable post-feed injection | Off | Master switch for post feeds. |
| Post-feed rules | Empty | One rule per line. |
| Post-feed selectors | Voxel defaults | Container, item and wrapper selectors. |
| Enable timeline injection | Off | Master switch for the timeline. |
| Timeline rules | Empty | One rule per line. |
| Timeline selectors | Voxel defaults | Tuned for Voxel's Vue timeline — leave alone unless customised. |
| Max injections per feed | 5 | Global cap across all rules. |
| Injection label | ADVERTISEMENT | Text above each injected ad. |
See Feed & Timeline Injection.
Single-post injection
| Setting | Default | What it does |
|---|---|---|
| Enable | Off | Master switch. |
| Post types | post | Comma-separated. |
| Content selector | Empty | CSS selector for the content container. |
| Rules | Empty | One rule per line. |
| Max ads per page | 3 | Global cap. |
Ad card styling
| Setting | Default | What it does |
|---|---|---|
| Card background | Empty (transparent) | Background of the ad card. |
| Border width / colour | 0 / #e5e7eb | Card border. |
| Corner radius | 10 | Card rounding. |
| Padding | 0 | Inset around the banner. |
| Vertical alignment | Stretch | Top, middle, bottom or stretch. |
| Show label | On | The "ADVERTISEMENT" mark. |
| Label colour / size / alignment | Inherited / 11 / center | Label styling. |
Privacy & consent
| Setting | Default | What it does |
|---|---|---|
| Require consent | Off | Withhold injection until consent is present. |
| Consent cookie | Empty | Cookie name your banner sets. |
| Accepted values | Empty | Comma-separated. Blank means any non-empty value. |
Geo targeting
| Setting | Default | What it does |
|---|---|---|
| Provider | ip-api | CloudFlare header, ip-api.com, ipinfo.io or Custom. |
| API key | Empty | Token for ipinfo.io. |
| Cache duration | 24 hours | How long to cache each visitor lookup. |
| When location is unknown | Show | Show or hide geo-targeted ads that can't be resolved. |
See Targeting.
License
License key entry, activation status, expiry and tier. See Installation & Licensing.
Maintenance
Tools rather than settings — see Maintenance & Troubleshooting.