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

# How to create URL-Triggered events in ShortPen

> Create URL-triggered events in ShortPen to track page visits, signups, and conversions automatically with your pixel.

**Short answer:** Create an event → choose **With URL** → add one or more URL rules (e.g., “contains `/thank-you`”) → **Save** → share your URL(s) with **Enable Tracking Events** on and verify in **Event Testing**. Events fire when a visitor loads a page that matches your rule(s).

<Info>
  **Don't know what URL-Triggered events are?** Learn more: [Understanding Events and Conversions in ShortPen](/key-concepts/events-and-conversions-overview)
</Info>

## Before you start

* You must have a [**Workspace**](/key-concepts/workspaces-overview) and a [**ShortPen Pixel installed**](/getting-started/install-shortpen-pixel) on your site/store. URL and code events rely on the pixel.
* If you want to attribute conversions to clicks from specific URLs, ensure [**Enable Tracking Events**](/link-management/links-settings/enabling-event-tracking) is on for those links.

## How to create a URL-Triggered event: Steps

<Steps>
  <Step title="Open Events → New event">
    Give the event a clear name (e.g., “Signup completed”). Consistent names help reporting.

    ***
  </Step>

  <Step title="Choose the trigger method → With URL → Select">
    This makes the event fire when a matching page is reached.

    ***
  </Step>

  <Step title="Pick the match type">
    * **Contains.** Path matches a part of the path (e.g., `thank-you`, `checkout/success`).
    * **Exact match.** Path matches exactly (useful for a single canonical page).

    ***
  </Step>

  <Step title="Enter the value (slug only)">
    Type only the **slug or path fragment**, not the full protocol or domain.

    <Tip>
      Example: type `thank-you`, not `https://yourbrand.com/thank-you`.
    </Tip>

    ***
  </Step>

  <Step title="(Optional) Add multiple rules">
    Click **+** to add more lines (each with its own match type).

    Use the trash icon to remove a rule.

    ***
  </Step>

  <Step title="Save">
    The event is tied to your selected pixel and starts recording when users reach a matching URL.

    You can test right away in the **Event Testing** panel.
  </Step>
</Steps>

## Test your event (recommended)

<Card title="How to test ShortPen events with the Event Testing Panel" icon="wand-magic-sparkles" href="/event-tracking/manage-events/events-testing" cta="Go to the guide">
  Use this guide to confirm events arrive in real time. Tests don’t affect live analytics.
</Card>

## FAQ

<AccordionGroup>
  <Accordion title="Does the event attribute to the original link click">
    Yes, as long as the visitor clicked a ShortPen link with event tracking enabled and then reached a matching URL, the event will be attributed in link analytics.

    <Info>
      **Learn more**: [How to view conversions for a single ShortPen Link](/analytics/link-level-analytics/link-conversion-analytics)
    </Info>
  </Accordion>

  <Accordion title="Can I change rules later">
    Yes. [Edit the event](/event-tracking/manage-events/events-editing) to add/remove rules. Future hits follow the new logic. Historical data remains unchanged.
  </Accordion>

  <Accordion title="What if my URL structure changes">
    Prefer Contains with stable fragments, or switch to a [Code-Triggered event](/event-tracking/manage-events/code-triggered-events) for full control.
  </Accordion>
</AccordionGroup>

## Related links

* [How to create your first event in ShortPen](/getting-started/create-first-event)
* [How to install the ShortPen Pixel](/getting-started/install-shortpen-pixel)
* [How to test ShortPen events with the Event Testing Panel](/event-tracking/manage-events/events-testing)
* [Understanding Events and Conversions in ShortPen](/key-concepts/events-and-conversions-overview)
* [How to create Code-Triggered events in ShortPen](/event-tracking/manage-events/code-triggered-events)
* [How to enable Event Tracking on a ShortPen Link](/link-management/links-settings/enabling-event-tracking)