Tips & Troubleshooting — HireLens Docs

Documentation

Title Section Slug Order Published

# Studio Tips & Troubleshooting

Get the most out of Analytics Studio and solve common issues.

---

## Keyboard Shortcuts

| Key | Action |
|-----|--------|
| `Delete` or `Backspace` | Remove the selected node or edge |
| `Escape` | Deselect everything |
| Click on edge (connection line) | Select it (for deletion) |

---

## Working with Connections

### Creating a connection
1. Hover over the **output port** (right side of a node) — it highlights
2. Click and drag to the **input port** (left side of another node)
3. Release to create the connection

### Removing a connection
1. **Click directly on the connection line** (the curved edge between nodes)
2. It highlights when selected
3. Press `Delete` or `Backspace`

### Inserting a node in the middle
1. Drag a new node from the palette
2. **Drop it directly onto an existing connection line**
3. The connection is automatically split — the new node is inserted between the two existing nodes

### Re-bridging on deletion
When you delete a node that is in the **middle** of a pipeline, connections are automatically re-bridged:
- Before: A -> B -> C
- Delete B: A -> C (automatic reconnection)

---

## Common Issues

### "No source node found"
**Cause:** Your pipeline does not have a Vacancies or Companies node.
**Fix:** Drag a source node onto the canvas and connect it to the rest of the pipeline.

### "Aggregate without Group By"
**Cause:** You have an Aggregate node but no Group By node upstream.
**Fix:** Add a Group By node between the Source/Filters and the Aggregate node.

### "Column does not exist" error
**Cause:** A Sort or Chart node references a column that does not exist at that point in the pipeline.
**Fix:** Click the Sort/Chart node and re-select the field from the dropdown — it only shows valid options.

### Empty chart
**Cause:** Your filters are too restrictive, leaving no data.
**Fix:** Relax filters (wider date range, fewer role restrictions) and re-run.

### Chart shows wrong data
**Cause:** Label or value columns are misconfigured.
**Fix:** Click the Chart node, then verify Label Column and Value Columns.

---

## Performance Tips

- **Use date filters** — Limiting to recent data makes queries faster
- **Limit results** — A Limit node of 20-50 rows keeps charts readable and queries quick
- **Simpler is better** — A pipeline with 3-5 nodes runs in under a second

---

## Best Practices

1. **Name your aggregates clearly** — `avg_salary` is better than `agg1`
2. **Build incrementally** — Add one node at a time and run after each addition to verify
3. **Use templates as starting points** — Modify rather than build from zero
4. **Check the preview** — Each node shows a preview of what it does below the title
5. **Group before aggregate** — Always add Group By before Aggregate, or you will get a single-row result

Documentation

New Article