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

# Changelog

# @overlayed/ads

<Update label="2026-07-07" description="v3.0.1" tags={[]}>
  * chore: fix builds
</Update>

<Update label="2026-05-13" description="v3.0.0" tags={["Breaking"]}>
  * refactor: Migrated ad providers.
    * `setKv` / `setKvs` → replaced by `refreshAdsViaDivMappings` (plus optional `setPageTargeting`).
    * `setUid`, `setAdsEnabled`, `showConsent` — **removed, no replacement.** User-id targeting and runtime ads-on/off are no longer part of the API; gate ad rendering at the call site by conditionally mounting the script / ad containers. Consent is handled internally by the new provider.

  * chore: bump internal dependencies

  * chore: update internal package versions
</Update>

<Update label="2026-04-11" description="v1.0.1" tags={[]}>
  * docs: fix typos and grammar across guides
</Update>

<Update label="2026-02-28" description="v1.0.0" tags={["Breaking"]}>
  * #### 🚀 Features

    * **Auto-updating support**: Complete implementation of application update flow including support for private channels
    * **Campaigns**: Ability to create UTM campaigns for tracking user acquisition
    * **Electron Window Logging**: Logs from electron windows will now be in feedback submissions
    * **Ads enhancements**: New `getAdsScriptElement` and `getAdsScriptUrl` methods for better ads integration
    * **Enhanced CLI bundling**: Improved the CLI bundling process to be more robust and reliable

    #### 📚 Documentation Improvements

    * **Deployment guides**: New [documentation](https://docs.overlayed.gg/deployment/introduction) sections on application deployments and updating mechanisms
    * **Refreshed docs theme**: Refreshed the docs theme
    * **Local Development**: Established guideliens for [local development](https://docs.overlayed.gg/advanced/local-development)

    #### 📝 Breaking Changes

    * After updating, you'll need to run `overlayed login` and then `overlayed init`. This only needs to be done once, and is only needed for local development.

    #### 🐛 Bug Fixes

    * Fixed broken documentation links

  * feat: internal changes for deployments

  * feat: Add getAdsScriptElement and getAdsScriptUrl utilities
</Update>

<Update label="2026-01-06" description="v0.2.1" tags={[]}>
  * chore: temporarily revert previous changes
</Update>

<Update label="2026-01-06" description="v0.2.0" tags={[]}>
  * feat: internal changes for deployments
</Update>

<Update label="2025-12-18" description="v0.1.6" tags={[]}>
  * chore: bump package versions
</Update>

<Update label="2025-10-06" description="v0.1.5" tags={[]}>
  * chore: update dependencies

    fix: various types exported from @overlayed/app like RenderWindow, etc.
</Update>

<Update label="v0.1.4" description="v0.1.4" tags={[]}>
  * fix: built package size
</Update>

<Update label="v0.1.3" description="v0.1.3" tags={[]}>
  * refactor: change internal build system
</Update>

<Update label="v0.1.2" description="v0.1.2" tags={[]}>
  * fix(ads): dist folder missing
</Update>

<Update label="v0.1.1" description="v0.1.1" tags={[]}>
  * fix: contextBridge not defined
</Update>

<Update label="v0.1.0" description="v0.1.0" tags={[]}>
  * feat: add ads support
</Update>