Learn Board Studio where you work. First-use guided tours introduce the main controls, while contextual Help explains the part of the interface you choose without performing its normal action.
Find the controls
Help and Settings are in the app header, not the canvas toolbar. The numbered circles identify controls, not steps.
Find Help and Settings in the header. The numbers identify controls, not steps.
- 1. Board help: select a control for an explanation without activating it.
- 2. Settings: open app preferences. This is separate from choosing a Help topic.
Get help with a control
- Select the blue question-mark Help button in the app header to choose a control for explanation.
- Move over the interface. Teachable regions highlight as you hover, so you can see which area will be explained.
- Click the highlighted region to open its Spotlight explanation. The click does not activate the underlying control or change the board.
- Read the explanation, then choose Close or Got it to dismiss the Spotlight.
Press Escape or click an empty area to leave the help picker without opening an explanation. Help does not open a topic browser or a banner first: choose the relevant region directly on the interface.
Help explains a control you choose; first-use tours introduce the interface in sequence. Explore is an optional longer walkthrough offered only for some topics, not a required step in using Help.
Help mode highlights Board insights without running an analysis.
Search help explains fields, scope and selection without changing Jira work.
Explore a topic in more detail
Some explanations offer Explore for a multi-step walkthrough of related controls. Use it when it appears to follow that topic through the interface. Other topics need only a single Spotlight explanation and do not offer Explore.
Help is available when you return to the app, not just during onboarding. Select Help again whenever you want to understand another control.
First-use guided tours
The initial tours introduce source selection and the main configuration areas. They are not a walkthrough of every feature, and the Help button is not a restart-from-step-one Tour button.
Before loading work
| Step | What it introduces |
|---|---|
| Source type | Choose Space for a Jira project or Filter for a saved Jira filter. |
| Source selection | Choose the particular Space or Filter to load. |
| Help | Learn how to request contextual explanations later. |
The initial three-step tour ends at Help before a data source is loaded.
After loading work
The post-load tour introduces these areas in order:
- Overview: understand the loaded source.
- General settings: adjust presentation choices.
- Board structure: arrange cards, dimensions and groups.
- Links: control dependency visibility, styling and routing.
- Update: refresh loaded Jira data.
- Help: find explanations when you need them.
Hierarchy controls are not extra steps in this onboarding sequence. Use contextual Help on their toolbar region when you are ready to explore them.
The six-step post-load tour ends at Help after introducing configuration and Update.
Find the right explanation
| Area | What to explore |
|---|---|
| Header | Source selection, saved configurations, Search and Update. |
| Configuration sidebar | Overview, general settings, board structure and links. |
| Hierarchy group | Hierarchy visibility, family corridors, family reveals and Parent Context. |
| Separate toolbar groups | Rolled-up links, card content and the timeline ruler. |
| Canvas actions | Navigation, Focus, layout, export, Board insights and Inspector. |
Help explains controls without changing what they do. Semantic level navigation and Back/Forward retain their existing behaviour; drawing a family corridor does not reveal cards, and revealing a family does not start impact highlighting.
Language and appearance
Guided tours and contextual Help are translated across all 27 supported locales and follow the app’s Jira language and theme. Jira work-item content remains your Jira data rather than translated help text.
Spotlights adapt their placement to the available app viewport, keeping the explanation and dismissal controls visible. When a sidebar target is outside its scroll area, the tour brings it into view.
The Search explanation scrolls while its dismissal controls remain available.
Related
- Your First Board: load, configure and save a useful view.
- Global App Interface: locate the main controls.
- Family Cards and Hierarchy: distinguish visibility, corridors and family reveals.
- Localisation and Themes: language and appearance preferences.





