# Add stickers and AR overlays on Web

> Apply a Web-compatible authored mask, sticker, animation, or 3D overlay from an authorized Nosmai Effects Web preview package.

> For AI agents: the complete documentation index is at https://nosmai.com/llms/effects.txt

Product: Nosmai Effects
Platform: Web
SDK version: 0.2.0
Group: guide
Source: https://nosmai.com/docs/effects/guides/stickers-and-ar-overlays/overview/web/

Available platform versions:
- iOS: https://nosmai.com/docs/effects/guides/stickers-and-ar-overlays/overview/ios.md
- Android: https://nosmai.com/docs/effects/guides/stickers-and-ar-overlays/overview/android.md
- Web: https://nosmai.com/docs/effects/guides/stickers-and-ar-overlays/overview/web.md
- React Native: https://nosmai.com/docs/effects/guides/stickers-and-ar-overlays/overview/react-native.md
- Flutter: https://nosmai.com/docs/effects/guides/stickers-and-ar-overlays/overview/flutter.md



> **Warning**
>
> **Developer Preview**
>
> Web `0.2.0` applies compatible authored packages. It does not expose the mobile
> SDK's direct runtime PNG, JPEG, or animated GIF face-sticker API.

## Prerequisites

- A working [Web quickstart](/docs/effects/quickstart/web/)
- Access to the authorized Web `0.2.0` developer preview
- A package marked compatible with the Web preview

## Choose compatible content

On Web, stickers and overlays are delivered as compatible authored effect
packages. A package may contain a face mask, image overlay, animation,
particles, triggers, or supported 3D content.

Use only an item marked as compatible with the authorized Web preview. Mobile
package compatibility does not automatically guarantee Web compatibility.

## Apply the overlay

Use the authorized package URL or package data supplied by the application.

```ts
const result = await sdk.applyEffect(selectedOverlayUrl);

if (!result.success) {
  throw new Error(result.error ?? 'AR overlay could not be applied');
}

console.info('Overlay compatibility', result.compatibility);
```

The authored package owns its supported face tracking, animation, triggers,
and visual resources. The Web preview does not expose raw face landmarks to the
application.

## Remove or replace it

```ts
await sdk.removeEffect();
```

Applying another package to the same visual category replaces the active
package.

## Verify

Test face loss and return, head rotation, camera permission restart, tab
visibility changes, HTTPS deployment, and the browsers targeted by the
application.

## Common errors

| Symptom | Fix |
| --- | --- |
| Mobile effect is rejected | Select a package marked as compatible with Web `0.2.0` |
| Package request fails | Check HTTPS, URL, CORS, Content Security Policy, and authorized asset hosting |
| Direct face-sticker method is unavailable | Use a compatible authored package; the mobile runtime sticker API is not available on Web |

## Next steps

- [Add an AR face mask on Web](/docs/effects/guides/effects/add-an-ar-mask/web/)
- [Understand Cloud Filters](/docs/effects/concepts/cloud-filters/)
- [Read the Web API reference](/docs/effects/reference/api/web/)

## References

- [Web installation guide](/docs/effects/installation/web/)
- [Cloud Filters](/docs/effects/concepts/cloud-filters/)
