---
title: "Custom conversion goals"
description: "Track signups, clicks, and other conversions with window.xpmetric() custom events."
source: "https://xpmetric.com/docs/custom-goals"
---
Conversion goals turn custom events into dashboard metrics — completion counts and conversion rate (CVR) — without extra schema setup.

## 1. Fire a custom event

After `p.js` is installed, call:

<EventSnippet event="signup" />

Examples:

```js
// After successful signup API response
window.xpmetric('signup');

// Newsletter subscribe
window.xpmetric('newsletter_subscribe');

// Pricing CTA click (when action completes)
window.xpmetric('pricing_cta_click');
```

The event name is a free-form string. Use lowercase with underscores for consistency.

## 2. Create a goal in the dashboard

1. Open your site dashboard.
2. Find the **Goals** card and click **Add goal**.
3. Pick a discovered event or enter the exact event name.
4. Save.

XPmetric counts completions from ClickHouse `event_type = 'custom'` rows matching your event name. **Goals are retroactive** — history before you created the goal still counts.

## Limits

- Max **10 active goals** per site
- Event names must match exactly (case-sensitive)
- Requires `p.js` on the page where the event fires

## Verify

Fire the event on your site, wait for the next dashboard poll (~60s), and check the Goals card for a new completion.

## Related

- [Conversion funnels](/docs/conversion-funnels) — chain pageviews and events into multi-step flows
- [Get started](/docs/getting-started) — install the tracker first