> For the complete documentation index, see [llms.txt](https://docs.synergysignal.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.synergysignal.io/signals.md).

# signals

The Signals (Entries) section controls whether long and short entry dots are displayed, and how frequently they appear on the chart.

## Settings (as they appear in the UI)

| Setting                   | Default | Description                                                        |
| ------------------------- | ------- | ------------------------------------------------------------------ |
| Enable Long Dots          | ✅ On    | Shows green dots at the bottom of the panel for long entry signals |
| Enable Short Dots         | ✅ On    | Shows red dots at the top of the panel for short entry signals     |
| Only plot on state change | ✅ On    | Dots only appear on the first bar of a new signal direction        |

## Use Cases for Disabling One Side

* **Disable Short Dots:** If you are trading a spot-only portfolio with no ability to short, hiding short dots reduces visual noise without affecting signal logic.
* **Disable Long Dots:** Useful if you are testing or running a short-only strategy.

Disabling one side of the dots does not affect the other side's logic or the position state machine.

## Only Plot on State Change

When enabled (default), the indicator tracks a position state (long, short, or flat) and only draws a dot on the bar where the state *changes direction*. A signal condition that persists for 5 consecutive bars draws only **one dot** — on the first bar it was true.

When disabled, a dot draws on every bar where the signal condition holds. Use cases for disabling:

* Understanding how long a condition persists across bars
* Debugging which bars satisfy signal conditions under different settings
* Visual strategy development and backtesting review

For live trading, leave this enabled for the clearest entry markers.