User guide
How to use CandleDraw
A reference for every part of the app: getting around the screen, then every tool, every study and every keyboard shortcut, and short videos of the app at work.
Top bar
The bar across the top of the canvas. The canvas opens after you sign in.
- Projects
- The square grid button at the left end opens your saved projects. See Saving and projects below.
- Title and version
- The app title, and the version number, which opens the changelog in a new tab. Both can be changed in Settings.
- Theme
- The sun or moon button switches between light and dark. It overrides the device theme until the device next changes.
- Export
- Opens the Export dialog. See Exporting below.
- Profile button
- Your avatar. Opens the profile menu, described below.
- On phones
- One row: projects and the title at the left, then the theme button, Export and the profile button.
Tool rail
The column of tools at the left of the canvas. Every tool is described on the Tools page.
- Tool buttons
- Click a button to pick its tool. Each tool also has a key, shown in its tooltip.
- Tool menus
- A small mark in a button's corner means it holds a menu of related tools. Click it to pick its tool and open the menu of the others.
- MagnetM
- Turns magnet snapping on or off.
- Studies
- Opens the Studies dialog. Available once the canvas has candles.
- Undo, Redo, Clear canvasCtrl/CmdZ
- At the bottom of the rail. Clear canvas asks you to confirm; Undo brings the chart back.
- Customizing
- Right-click the rail to open the Tools section of the Menu, where you choose which tools it shows.
- Quick tool menu
- Middle-click the canvas (press the scroll wheel) for a ring of four favorite tools. Choose them in Menu, Tools.
- On phones
- The rail folds to Select, the current tool when it is another one, and a chevron. The chevron opens every tool in a scrolling list; a touch outside it folds it again.
Moving around the canvas
Panning and zooming change only the view, never the chart.
- Pan
- With the Select tool, drag empty canvas. With any tool, scroll with the mouse wheel or swipe on a trackpad.
- ZoomCtrl/CmdScroll
- Hold Ctrl or Cmd and scroll, or pinch on a trackpad, at the pointer.
- Touch screens
- Drag with two fingers to pan, pinch to zoom.
- Candle width and height
- Drag the ruler along the bottom to widen or narrow the candles, and the ruler at the right to stretch or squeeze them vertically. Focus a ruler and use the arrow keys for small steps. The button where the rulers meet resets both. Shift+R shows or hides the rulers.
- Fit to screenShiftF
- Zooms out until every visible candle is in view. It never zooms in.
- OHLC crosshair
- While the pointer is over the chart, a guide line follows it and a readout shows the nearest candle's open, high, low and close. Turn it off in Menu, Canvas.
Properties panel
The panel at the right edits what is selected and lists everything on the canvas. The arrow at its top edge collapses it and opens it again.
- Candle settings
- For the selected candle layer: Chart (chart type, price scale, the data's timeframe), Candle shape (width, wick thickness, wicks) and Candle colors. It opens when a candle is selected and can be collapsed.
- Price scale
- Linear, logarithmic or percent for the selected layer. Switching keeps the prices and moves the candles.
- Selected drawing
- The settings of the selected drawing, grouped as Style, the tool's own groups and Visibility. Each tool's settings are on the Tools page.
- Several selected
- With more than one drawing selected: Align, Distribute and Grouping, plus line thickness and opacity for all of them.
- Selected study
- Data, Inputs and Style. Each study's settings are on the Studies page.
- Reset to default
- The arrow beside a slider or number field puts that one value back to its built-in default. It is dimmed while the value is the default.
- Recent colors
- Below each color field, the last eight colors you picked. One click applies a color.
- Set as default
- New drawings and studies of the selected kind start with its settings. Clear custom default returns them to the built-in settings; the selected one keeps its own.
- Layers
- Every candle layer, drawing and study. New layer starts a new candle layer. Each row can be hidden, locked, renamed, moved up or down, duplicated or deleted. Click a row to select it.
- Candle layer lock
- A locked candle layer cannot be moved, resized or deleted, and new candles are not drawn into it. Its colors still change.
- Hide all, Lock all
- Act on every drawing at once. Candle layers are not included.
- Hide all studiesShiftH
- Above the Studies list in Layers. Shows them all again when every study is hidden.
Right-click menus
Right-click a drawing, a candle or a study's line, or anywhere in a study pane, for its menu: Properties and Delete. A pane holding several studies lists both for each study. On a phone, press and hold it instead. Right-click empty canvas for the canvas menu: Fit to screen, Studies, Hide all studies and the Menu sections.
- Properties
- Selects it and opens its settings in the Properties panel, opening the panel if it is folded. The rest of the screen dims for a moment around the settings.
- DeleteDelete
- Deletes it, or the whole selection when you pressed one of several selected drawings. One undo step. Dimmed on a locked drawing or on an assignment's own content, with the reason in its tooltip. The Delete key does the same.
- Fit to screenShiftF
- Zooms out until every visible candle is in view. It never zooms in; when the candles fit already, it only centers them. Shift+F does the same.
- Studies
- Opens the Studies dialog for the chart's candle layer.
- Hide all studiesShiftH
- Hides every study, or shows them all when none is visible. Shown when the chart has studies. Shift+H does the same.
- Canvas, Tools, Settings
- Canvas, Tools and Settings open that section of the Menu dialog.
- Grid
- The editing grid.
- Gradient
- The canvas background gradient, for the current theme.
- Edge rulers
- The bottom and right rulers. Shift+R also shows or hides them.
- Timeframe strip
- The timeframe strip.
- OHLC crosshair
- The guide line and price readout under the pointer.
- Magnet snappingM
- Snapping to candle prices.
Timeframe strip and split view
The strip in the bottom-left corner of the canvas reads a candle layer at another timeframe without changing it.
- Timeframe strip
- Click a timeframe, M1 to W1, to view the layer at that timeframe. The candles you drew stay as they are; select the layer's own timeframe to return to them.
- Estimated candles
- A timeframe below the layer's own is a simulated breakdown, not real data. The strip then shows a warning triangle, and hovering or focusing the strip explains it.
- The data's timeframe
- The strip starts from the layer's own timeframe. If it is wrong, correct it in Candle settings.
- Split view
- The split button on the strip opens a second pane that shows the same layer at a second timeframe. The panes scroll together; each keeps its own zoom. Not on phones.
Studies and study panes
Studies are added from the Studies dialog, listed in Layers, and edited in Properties.
- Studies dialog
- Opened from Studies on the rail or the right-click menu. Filter by name or column, and click a row to add the study. Pattern detection opens its own panel from here.
- Favorites
- The star on a row puts that study in a Favorites group at the top of the list.
- Study panes
- RSI, MACD and the other pane studies sit in a section under the bottom ruler, newest at the top. Past half the canvas height the section scrolls.
- Resizing a pane
- Drag the strip above a pane.
- Moving the chart from a pane
- Dragging, scrolling and zooming inside the panes move the chart, and the crosshair line runs through them.
- Selecting a study
- Click its line, on the chart or in its pane, to select it and edit it in Properties. Right-click its line or its pane, or press and hold it on a phone, for Properties and Delete. The Delete key also deletes a selected study.
Candle Player
Replays the chart candle by candle. Open it from the profile menu; a transport bar appears over the canvas.
- Play and pause
- Starts and pauses the replay. Each candle forms from its open to its close.
- Back to the start
- Returns the replay to its start point.
- Speed
- How fast the candles form.
- Record
- Records the replay and downloads it as a video when you stop.
- Settings
- The gear button opens a panel you can drag aside. Source: Replay chart replays the candles on the canvas; Generate new builds a fresh sequence, of the length set in Generated candles, and leaves it on the canvas.
- Start point
- Set start point, then drag on the chart to aim the line or click to drop it, and Confirm start point. Candles past the line are faded until they play. Start at the beginning clears it.
- Exit Candle Player
- The close button on the transport bar, or the profile menu row.
Saving and projects
The canvas saves as you work.
- Autosave
- Every change is saved on this device, and to your account shortly after, so the drawing follows you to another device.
- Undo and redoCtrl/CmdZ
- Undo steps back through your changes, redo steps forward again.
- Save project
- In the projects menu, name the canvas and give it an optional category, then Save project. Your plan sets how many projects you can keep.
- Open, Save over
- Click a project to open it on the canvas. Save over replaces a project with the current canvas.
- Project lock
- The lock on a project row stops it from being saved over or deleted until you unlock it. A locked project still opens.
- Delete
- The bin on a project row deletes that project.
Exporting
Export in the top bar opens the Export dialog. It opens with the choices of your last image export.
- Area
- Full chart crops to your drawing, including anything off screen. Current view crops to what is on screen. Region lets you drag a box: Select region…, then Redraw or Clear.
- Background
- Solid uses the canvas background, with a 2 px margin in the same color. Transparent leaves the background empty.
- Include study panes
- Shown when the chart has study panes. Adds them under the chart in the image.
- Download PNG
- Saves the image. The file name starts with the date and time, so exports do not overwrite each other.
- Copy to clipboard
- Copies the image to paste into another app.
- Download CSV
- The candles as open, high, low and close rows. Uses the imported prices when the layer was imported.
- Download JSON
- The whole document, candles, drawings and studies, as a file.
- Watermark
- Images carry the watermark set in Menu, Canvas. It is drawn on the chart only, never on the study panes.
On phones
The same app, arranged for a narrow screen.
- Tool rail
- Folded to Select, the current tool and a chevron that opens every tool.
- Long press
- Press and hold a drawing, a candle, a study's line or a study pane to open its menu: Properties and Delete.
- Menu dialog
- Opens on a section, with a Back arrow to the list of sections and Sign out.
- Education Hub
- Opens on a section, titled by it, with a Back arrow to the list of sections.
- Left out
- Split view is not offered on phones, and the Guide row shows no ? key hint.
Profile menu and Menu dialog
The profile button opens a menu. The first rows open a section of the Menu dialog; the others open help, the Candle Player, or sign you out.
- Account
- Opens the Menu dialog at Account, described below.
- Canvas
- Opens the Menu dialog at Canvas, described below.
- Tools
- Opens the Menu dialog at Tools, described below.
- Import
- Opens the Menu dialog at Import, described below.
- Settings
- Opens the Menu dialog at Settings, described below.
- Support
- Opens the Menu dialog at Support, described below.
- Guide
- This guide, in a dialog over the canvas, with a search and the keyboard shortcuts as its last tab. The ? key opens it on the keyboard shortcuts. The dialog's Getting started button, tagged Beta, opens a short walkthrough of drawing a first chart; the walkthrough also opens by itself once, the first time the account has the tools it covers. An account without those tools gets short hints on its first visit to the canvas instead, from picking the Draw candle tool (the rest of the screen dims around it) to three drawn candles, then to the drawing tools on the rail; Skip tips ends them. On the public pages the Guide row opens this guide in a new tab.
- My assignments
- For students in a class: your assignments, with a count of those still to do.
- Candle Player
- Replays the chart candle by candle. Tagged Beta. While it runs, the row reads Exit Candle Player.
- Sign out
- Signs out on this device.
Menu, Account
Your profile details, plan and subscription, the ways you sign in, and your data.
- Profile
- Your display name, email and account ID, each with a Copy button.
- Subscription
- Your plan and what it includes. Manage billing opens the payment page; Switch to another plan or Cancel subscription from here.
- Authentication
- The ways you sign in. Connect Google, set a password, or add a passkey. Any connected method opens the same account. Passkeys are not offered while a Google sign-in is connected.
- Advanced
- Download your data as a file, or delete the account. Deleting asks you to confirm first and cannot be undone.
Menu, Canvas
How the canvas looks and behaves: chart type, background, grid, watermark, chart customization, edge rulers, the timeframe strip, the OHLC crosshair and colorblind-safe candles.
- Chart type
- The style for new candle series: candles, bars, line, Heikin-Ashi, renko or range bars. An existing series changes from its Candle settings.
- Canvas background
- The canvas color, set separately for light and dark mode. A gradient blends toward a second color at the edge you pick.
- Grid
- A guide grid shown while you edit, never in exports. Set its color, size in pixels and opacity.
- Watermark customization
- A text or logo watermark on downloaded and copied images: the text, font size, logo image, location and opacity.
- Chart customization
- Persistent keeps your candle colors, candle settings and tool settings for new canvases. Defaults starts each new or cleared canvas from the built-in settings.
- Edge rulers
- Shows or hides the rulers along the bottom and right edges. Hidden, their space goes to the canvas. Shift+R on the canvas does the same.
- Timeframe strip
- Shows or hides the timeframe strip in the bottom-left corner of the canvas.
- OHLC crosshair
- While the pointer is over the canvas, shows a guide line and the nearest candle's open, high, low and close.
- Colorblind-safe candles
- Draws bullish candles hollow and bearish candles filled, so direction does not depend on telling red from green.
Menu, Tools
Which tools the rail shows and in what order, magnet snapping, and the quick tool menu.
- Tools menu
- Which drawing tools the rail shows between the pinned Select and Eraser. Add a tool from Available tools to Your toolbar, drag or use the arrows to reorder it, or remove it.
- Magnet snappingM
- Snaps dragged elements to nearby edges, centers and candles. Hold M while dragging to do the opposite of the setting.
- Quick tool menu
- Four favorite tools, one for each corner: Top left, Top right, Bottom left and Bottom right. Middle-click the canvas (press the scroll wheel) to open the ring and pick one.
Menu, Import
Import OHLC data from a CSV file as a new candle layer.
- Import OHLC data
- Choose a CSV file of open, high, low and close prices, with time and volume where the file has them. The rows open as a new candle layer you can edit, replay and run studies over.
- Where to get OHLC data
- Most trading terminals export it. In MetaTrader, open the History Center from the Tools menu, pick a symbol and a timeframe, and export the rows as CSV.
Menu, Settings
The theme, app branding, and Reset defaults.
- Theme
- System follows your device, including its automatic switch between light and dark. Light or Dark holds that theme.
- App title
- The name in the top bar, in place of CandleDraw.
- App subtitle
- A second line of text beside the title.
- App accent color
- The color of buttons, active states, sliders and focus rings.
- Show the version in the top bar
- Shows or hides the version number beside the title. The number links to the changelog.
- Reset defaults
- Puts the Settings, Tools and Canvas sections back to their defaults, and lists what it resets before you confirm. Your drawing and saved projects are not touched.
Menu, Support
A form that sends a question or a problem to support.
- Category
- What the message is about.
- Subject
- A short title for the message.
- Message
- The question or problem. Send message sends it; the reply goes to your account email.
Education Hub
For educators: students, classes, assignments and review, from the profile menu. Students reach their work from My assignments.
- Education Hub
- The start of the Education Hub: what it holds and where to begin.
- Affiliate program
- Your referral link and code, and the accounts that joined through it.
- Cohorts
- Groups of students. Invite students with your code, and release work to a whole group at once.
- Build
- Make assignments on the canvas, and sections that group them.
- Link
- Release assignments and sections to cohorts, and choose when.
- Review
- Read submitted work, mark it with ink on the student's canvas, then approve it or return it for revision.
- Building an assignment
- In Build, an assignment is made on the canvas in three steps: Name it and choose the reveal, Build the finished chart, then Choose the student work by clicking the drawings, studies or candles students must add. The tools they need are lent to them.
- Solution reveal
- After submission shows the answer key when the student submits, so a submission is final. After your review shows it when you approve the work, and returned work can be revised. Never keeps it hidden.
- Reveal boundary
- Instead of marking candles, place a line on the chart: candles to its right are hidden from the student. They show with the answer key, as set in Solution reveal (after submission, after your review, or never), and then play in one by one in the Candle Player. It cannot be used together with marked candles.
- Students
- My assignments lists the work released to your class. Open assignment, draw your answer, then Submit work. Returned work reopens for revision with the educator's feedback; Resubmit work sends it again.