
Absolutely! See the following example:

```js
airgap.addEventListener(
  'consent-change',
  ({ detail: { consent, oldConsent, changes } }) => {
    console.log('old consent:', oldConsent);
    console.log('new consent:', consent);
    console.log('consent changes:', changes);
  },
);
```


Can I subscribe to consent changes with an event listener?


The `airgap.getConsent()` API returns an object in this format:

```ts
interface TranscendConsentPreferences {
  /** consent to individual tracking purposes */
  purposes: {
    /**
     * true -> confirmed consent
     * false -> unconfirmed consent or opted out
     * 'Auto' -> unconfirmed consent, but opted in by default
     */
    [TrackingPurpose in string]: boolean | 'Auto';
  };
  /**
   * Was tracking consent confirmed by the user?
   * If this is false, the consent was resolved from defaults & is not yet confirmed
   **/
  confirmed: boolean;
  /**
   * Consent update/sync timestamp (ISO 8601 format)
   * e.g. "2021-06-29T19:16:13.964Z"
   */
  timestamp: string;
}
```

It's noteworthy that the value for each of the purposes can be one of 3 values:

- `true`: The website visitor explicitly confirmed consent for that purpose.
- `false`: The website visitor explicitly unconfirmed consent for that purpose, OR the website visitor was opted out by default based on your [regional experiences](https://app.transcend.io/consent-manager/regional-experiences) configuration.
- `'Auto'`: The website visitor is opted in by default based on your [regional experiences](https://app.transcend.io/consent-manager/regional-experiences) configuration. The website visitor has never explicitly confirmed consent for that purpose.

Example:

```js
await airgap.sync();
const { purposes } = airgap.getConsent();
console.log(JSON.stringify(purposes, null, 2));
// example log message: { Functional: true, Advertising: true, Analytics: true }
```


How do I get a user's current consent?


See [Restoring consent to users from your backend](/_docs/consent-management/configuration/persist-consent.mdx#restoring-consent-to-logged-in-users-from-your-backend).


How do I restore consent to logged-in users from my backend?


Consent changes require proper authorization. See [consent authorization](/_docs/consent-management/configuration/creating-your-own-ui.mdx#consent-authorization) to learn more.

- Option 1: Set specific tracking preferences
  **airgap.js onload**

```html
<script
  src=".../airgap.js"
  onLoad="airgap.setConsent(event, { Functional: true, ... })"
></script>
```

**HTML**

```html
<button onClick="airgap.setConsent(event, { Functional: true, ... })">
  Save tracking preferences
</button>
```

**JavaScript**

```javascript
saveConsentButton.addEventListener('click', (event) => {
  airgap.setConsent(event, { Functional: true /* ... */ });
});
```

- Option 2: Opt-in or opt-out to all tracking preferences (`airgap.optIn()` and `airgap.optOut()`)
  **HTML**

```html
<button onclick="airgap.optOut(event)">Opt-out</button>

<button onclick="airgap.optIn(event)">Opt-in</button>
```

**JavaScript:**

```javascript
optOutButton.addEventListener('click', airgap.optOut);

optInButton.addEventListener('click', airgap.optIn);
```

- Set "Do not sell my personal information" tracking preference

```javascript
// "Do not sell my personal information" consent (CCPA/CPRA)
saleOfInfoOptOutButton.addEventListener('click', (interaction) => {
  airgap.setConsent(interaction, { SaleOfInfo: false });
});

saleOfInfoOptInButton.addEventListener('click', (interaction) => {
  airgap.setConsent(interaction, { SaleOfInfo: true });
});
```


How do I set user consent from my website UI?


See [Syncing consent to your backend](/_docs/consent-management/configuration/persist-consent.mdx#storing-consent-on-your-backend).


How do I store consent on my backend?


Consent preferences are persisted in localStorage directly on the end-user's browser. If the end user has previously been on your website on that browser, then the consent preferences will be restored from their prior session.


How is consent stored?


Action Item digests are sent via email or Slack notification every day, Monday-Friday, at 9:00 am Central time.


Preference Management

Featured Guides

Preference Management Implementation

Preference Management Overview

Storing Consent Preferences