# Understanding Signal Groups

> Source: https://docs.trailspark.ai/docs/signal-groups

## What Signal Groups Are

Signal groups are automatic collections of staged signals that share common characteristics. Instead of browsing thousands of individual signals, the Signal Queue tab groups similar signals together by source, event type, URL path, form data, and content type.

## Accessing Signal Groups

Navigate to **Signal Mapping** > **Signal Queue** tab.

<img src="/api/images/3382ec7c-76c5-40a4-86aa-154a20cb88fe/file" alt="Trailspark Signal Mapping Queue" width="600" />

## Group List View

Each group row shows:

| Element | Description |
|---------|-------------|
| **Expand arrow** | Click to see a sample payload |
| **Group title** | Pattern descriptor: `[EventType] - [ContentDescriptor] ([Path]) [ContentType]` |
| **Source badge** | Signal source system |
| **Count badge** | Number of signals in the group |
| **Actions** | View Details and Create Rule buttons |

Groups are sorted by signal count (highest first), then alphabetically by event type.

### Title Examples

- `form_submit - ContactForm (pricing_page) [action]`
- `page_view (dashboard) [webpage]`
- `download - Whitepaper [asset]`
- `identify [action]`

## Expanding a Group

Click the expand arrow or group title to see:

- **Sample payload** -- JSON preview of a representative signal (prioritizes signals with email addresses)
- **Signal count** -- Total matching signals
- **Quick actions** -- Link to view all signals in the group

## Group Details Page

Click **View Details** to see full group information:

**Characteristics displayed:**

| Field | Description |
|-------|-------------|
| Source | Signal source system |
| Event Type | Type of event |
| Path | URL path (if applicable) |
| Form Type / Form ID | Form details (if form-related) |
| Page / Asset / Action | Content identifiers |
| Webinar | Webinar name (if applicable) |
| Content Type | Category: asset, webinar, webpage, action |

**All Signals table** lists every signal in the group with columns for Signal ID, Created At, Differences (unique values like User ID, Email), and a **Create Rule** button per signal.

## Creating Rules from Groups

**From the group list**: Click **Create Rule** on any group. The rule creation form opens with the sample signal pre-loaded.

**From group details**: Click **Create Rule From Sample** for the group's representative signal, or click **Create Rule** on any individual signal in the table.

> [!TIP]
> Start with your highest-count groups to cover the most signals with each rule.

## How Grouping Works

TrailSpark extracts a fingerprint from each signal based on:

- Signal source and event type
- URL path and page URL
- Form ID and form type
- Page name, asset identifier, action type, webinar data
- Content type category

Signals with identical fingerprints are grouped together.

## Searching

Use the search box to filter groups. Search is case-insensitive and matches against event type, signal source, page path, form type, asset name, action type, and webinar name.

Click **Refresh** to reload signals from the server and update group counts.

## Next Steps

- [Creating Signal Mapping Rules](/docs/creating-signal-mapping)
- [Understanding Signals](/docs/signals-overview)
- [Webhook Configuration](/docs/webhook-configuration)