Journalit
Journalit

Getting Started

WelcomeWhat's NewInstallationQuick StartAuthentication

Journaling

Home ViewManual EntryTrade NotesTrade LogSetupsSession Mode

Reviews & Analytics

DashboardReview System

Accounts & Prop Firms

Account ManagementProp Challenges

Customization

Layout BuilderNavigation SidebarSettings

Import & Integrations

Trade ImportMCP
Trade Sync Guides
Broker Export Guides
DownloadSign In
Docs/Customization/Settings

Settings

Continue with Journalit

Trading platformsCompare direct sync and supported imports.CSV trade importImport broker exports into your journal.Obsidian pluginUse Journalit inside your vault.Trading journal templateSee the default vault structure.MetaTrader journalUse MT4 sync or import MetaTrader statements.

Navigation Sidebar

Previous Page

Trade Import

Next Page

On this page

How To Open SettingsOpen the command paletteRun the settings commandOr use Obsidian's plugin settingsSettings OverviewConnectionsYour accountTrade SyncTrade ImportEconomic CalendarMCPJournal setupTrade formReviewsSession ModeCustom fieldsConvert a custom field to RatingSymbols and tagsSymbol mappingsCalculationsPreferencesCurrency and datesAppearance and navigationOpening linksPrivacyNotificationsFiles and backupsJournal folder and image pathsBackup, restore and resetMedia GalleryBest PracticesSet the foundations firstKeep your taxonomy tightTreat Trade Sync as an operations surfaceBack up settings before major changes

Settings is where Journalit becomes your actual trading workspace instead of a generic plugin install. This is where you define how notes are created, how reviews repeat, how Trade Sync behaves, and how your own taxonomy is applied across the system.

Settings structure

Journalit's settings open on a home screen with five sections: Connections, Journal setup, Calculations, Preferences, and Files and backups. Each one opens as its own page, and the back arrow at the top returns you to the previous page.

Obsidian's settings search finds Journalit's settings directly, so you can type a setting's name instead of remembering which page it lives on.

How To Open Settings

Open the command palette

Press Ctrl+P in Obsidian.

Run the settings command

Search for Open settings and run it.

Or use Obsidian's plugin settings

You can also open Journalit from Obsidian's Community Plugins settings area.

Settings Overview

Journalit settings home with the Journalit logo, Docs, Discord and GitHub buttons, and rows for Connections, Journal setup, Calculations showing Day ends 23:59, Preferences, and Files and backups

Connections

Your Journalit account and plan, Trade Sync, Trade Import, the Economic Calendar, and MCP.

Journal setup

The trade form, reviews, Session Mode, custom fields, and your symbols, tags, mistakes, and events.

Calculations

The trading day, how analytics count trades, default risk, and break-even rules.

Preferences

Currency and dates, appearance and navigation, Privacy Mode, and update notifications.

Files and backups

Journal folder, image path maintenance, settings backup, import, export, reset, and Media Gallery folders.

The home screen also links to the documentation, the Discord community, and the GitHub repository. Some rows show their current value on the right, such as the time your trading day ends, so you can check it without opening the page.

Journalit's interface language follows Obsidian's own language setting rather than a separate control. Changing Obsidian's language changes Journalit's. Arabic is supported with a right-to-left layout.

Connections

Connections covers your Journalit account and everything that talks to the Journalit servers or to your AI apps. It opens with your account, followed by four pages.

Your account

Connections page showing an account card with the signed-in email, a Pro badge, Signed in status, Sign out and Manage subscription buttons, and the features included in Pro, above rows for Trade Sync, Trade Import, Economic Calendar, and MCP

Account card

Your signed-in email, a badge for your plan, and whether this device is signed in.

Included in your plan

A ticked list of the features your plan includes. On the Free plan, locked features open the upgrade window when you click them.

Sign in or sign out

Start the device sign-in, or sign out cleanly from the current account.

Manage subscription

Open your journalit.co dashboard to handle subscription details. Free accounts also get an Upgrade to Pro button.

Related page

For the full sign-in and account-linking behaviour, see Authentication.

Trade Sync

The Trade Sync page is the operations surface for broker connections, not a single toggle. Providers sit on their own tabs, each with its own connection state.

Provider tabs

Each broker sync provider gets a tab with independent connection and account state.

Status cards

Connection health, last sync time and total sync count, and the number of linked accounts, with refresh, sync, and manage actions.

Setup & Configuration

The provider-specific connection flow, including MetaTrader FTP credentials and the website connection for the other providers.

Sync Settings

Automatic sync behaviour and the controls for how often Journalit checks for new trades.

Account Management

Assign each provider account to the local Journalit account that should receive its trade notes, and relink or unlink accounts.

Notification Settings

Whether sync results and newly arrived trades raise a notice.

Access is gated twice

Trade Sync requires both a signed-in account and a plan that includes it. When either is missing the page says so rather than presenting controls that cannot work.

Related page

Start with the Trade Sync overview, then use the setup guide for your provider.

Trade Import

Trade Import settings are about recovery rather than configuration. They restore broker-file imports across vaults and recover missing local trade notes.

Connection

Whether the Journalit server is reachable, with a check action.

Import backup

Check how many previously imported trades could be restored into this vault.

Import history

A newest-first list of past imports in a collapsible section. Each has an actions menu to delete that import from the server. Trades that another import still backs are kept.

Delete account from server

Available from an account's row menu and when deleting a local account. Broker-synced accounts cannot be deleted this way.

Open Trade Import

Jump into the import workflow itself when you want to bring in new broker files.

Deleting an import from the server can remove the trades it created from every vault that syncs with your account. Trades still backed by another import are kept. The confirmation states how many trades will be deleted; do not treat an import deletion as a way to reverse every change to an earlier trade.

Import history list showing one manual import with its date, source, trade count on the server, and an actions menu

Economic Calendar

Economic Calendar settings control which events are copied into Weekly Review Key Events automatically. The row on the Connections page shows whether automatic import is on. Browsing filters in the calendar view are saved separately, so changing what you are looking at does not silently change the automatic-import scope.

Auto-import weekly events

Keep the current weekly note in sync with the calendar feed.

Currencies

Choose the currencies relevant to the markets and sessions you trade. Selecting none includes all.

Impact levels

Select the impact levels that belong in the automatic weekly context.

Include holidays

Import bank holidays and central-bank minutes as all-day entries.

Economic Calendar settings showing automatic weekly event import enabled, USD selected under currencies, all impact levels selected, holidays included, and the Open Economic Calendar button

Deletions are respected

Events you deliberately delete from Key Events stay deleted. Automatic import does not put them back.

MCP

MCP is where you let MCP clients such as Claude, ChatGPT, and Claude Code work with this vault. Turn on MCP access, choose whether agents get full access or must ask for approval, check monthly usage, and open AI agent activity. See Set up AI access in Journalit.

Journal setup

Journal setup controls the repeatable structure behind trade entry, review notes, Session Mode, and your own taxonomy.

Journal setup page showing the Trade form row with a Customise layout button, followed by rows for Reviews, Session Mode, and Custom fields

Trade form

Customise layout opens the trade form layout editor. It decides which blocks appear in the trade form and how you enter trades.

Input mode

Enter trades from prices, or from P&L and risk when full price reconstruction is not useful.

Asset type

Ask for the asset type on every trade, or fix it to the one you always trade.

Position size

Enter position size as a quantity or as a dollar value. Dollar value suits stocks, since futures and forex carry contract multipliers.

Trade times

Enter entry and exit times as HH:MM, or include seconds with HH:MM:SS.

MAE / MFE entered as

Inside the Risk Management block: enter excursions as price levels or as dollar values.

Blocks

Show, hide, and reorder the optional Basic, Details, and Advanced blocks.

See Manual Trade Entry for the full layout editor.

Reviews

Review layouts

Open Layout Builder to create, edit, and preview the layouts that new review notes are built from.

Recurring goals

Daily goals and weekly goals that appear automatically in each new review, editable per review.

Checklists

The DRC checklist and the Weekly checklist: repeatable items copied into each new Daily Report Card and Weekly Review.

Create reviews automatically

After the first trade of a period, create that period's review. One switch covers daily through yearly reviews.

Create when opening an empty period

Separately for Day, Week, Month, Quarter, and Year, create the review when you open a period that does not have one yet.

Related pages

Use Layout Builder to build the layouts themselves, and see the broader workflow in Review System.

Session Mode

Session Mode settings cover session windows, preparation, phase layout, Trade Gate workflows, and Session Log tags. See Session Mode for the workflow itself.

Custom fields

Custom fields has two pages: Trade fields and Review fields. The editor is considerably more capable than a simple text-field adder.

Field types

Create text, number, dropdown, multiselect, date, datetime, and time fields.

Validation rules

Set required fields, text length limits, and numeric min or max constraints where appropriate.

Field ordering

Move custom fields up or down to control the order shown in settings and in the trade form Advanced tab.

Trade Log currency display

Format number fields as currency in Trade Log columns when a custom metric represents money.

Dropdown and multiselect options

Manage allowed option values directly in settings instead of relying on free-form note edits.

Frontmatter key preview

See the generated field key and catch reserved-key conflicts before saving the field.

Cross-app usage

Custom fields can flow into Trade Log columns and into filtering across Trade Log, Dashboard, and Review notes where supported.

Review fields are managed separately from trade fields. Use them when you want structured planning context such as bias, focus, intent, or mistakes to avoid in DRCs and higher-timeframe review notes without adding those fields to every trade note.

Named review field groups include move-up and move-down controls. Their saved order controls how the groups appear in Review Context Fields widgets, including widgets that are already open. Ungrouped fields remain at the end.

Convert a custom field to Rating

For a number, dropdown, or text trade field, open its editor and choose Convert to Rating. Select the original scale, such as out of 3, 5, 10, or 100, then map each distinct value to the built-in half-star scale.

Trades with a different existing rating are kept unless you choose to overwrite them. Trades edited after you open the conversion are left alone and listed for review. Conversion retains the custom values; after checking the results, use the separate removal step to clear converted values and delete the field when the remaining notes permit it.

Symbols and tags

The Symbols and tags group is where Journalit learns your trading language. Each row opens its own page.

Symbols

The tickers you trade, with their asset type and per-ticker cost rules.

Symbol mappings

Map contract-specific symbols such as NQZ5 to a base symbol such as NQ for automatic spec lookup.

Tags

Labels you add to trades. Custom tags can use their own colours.

Mistakes

The mistakes you record on trades, kept consistent across trade forms, filtering, and review.

Events

Recurring market-context events, with colours and default notes for events you annotate repeatedly.

Setups and account types live elsewhere

Setups are managed in the Setups view, and account types in Accounts settings, not here.

Tags use one global library across trades, Setups, and media annotations. Renaming, merging, or deleting a tag also updates matching media annotations and Day Trade Fields. Resetting the tag library does not remove tags already stored in notes.

Instrument settings modal showing account-specific commission cost rules for a futures ticker

Commission rules apply to future manual trades and imports when the commission field is empty or zero. Use them when a symbol has predictable costs that you do not want to type into every trade.

Symbol mappings

Imported to base symbol mapping

Map alternate imported names back to a canonical symbol so trade data stays consistent.

Broker-format cleanup

Useful when broker exports and your preferred naming scheme do not match.

Calculations

Calculations decides how trades are grouped and measured. Changing these settings changes your analytics, not the trades saved in your notes.

Calculations page showing Trading day settings for Day ends at and Exclude weekends, and Analytics settings for Date trades count on, Include unrealized P&L, and Include copy accounts

Day ends at

The cutoff time that ends a trading day. Trades after it are grouped with the next day.

Exclude weekends

Treat Saturdays and Sundays as non-trading days. Turn it off if you trade or review at weekends.

Date trades count on

Group trades by entry date, or by final exit date. Exit-date mode only counts closed trades.

Include unrealized P&L

Include open positions that carry a price snapshot in net P&L totals, shown separately from realised results.

Include copy accounts

Let all-account analytics include derived copy-account results and count them as account-level trades.

Default risk per trade

The risk figure used for R-multiple calculations. Leave it empty to require a value per trade.

Break-even rule

Treat break-even as a fixed P&L range, or as a percentage of each account's current balance.

Include unrealized P&L affects net P&L totals only. Outcome statistics such as win rate and streaks stay realised-only, because an open position has not produced a result yet.

Preferences

Preferences holds the settings you feel every day: how numbers and dates look, how Journalit opens, and whether sensitive numbers are visible.

Preferences page showing rows for Currency and dates with USD and DDMMYY, Appearance and navigation, Privacy showing Off, and Notifications

Currency and dates

Currency

The currency used to display monetary values throughout the plugin.

Show results as R-multiples

Show R-multiples instead of currency amounts. Values that have an R form show R, or a dash when the R is unknown, and never fall back to currency. Balances, prop challenge rules, payouts, and fees stay in currency.

Hide dollar amounts in R mode

While results show as R-multiples, the trade form shows the result, MAE, and MFE in R only, and drops currency from its 1R and saved-value hints. Trades are still saved in your currency, and Risk Amount and fees still show. It is available once Show results as R-multiples is on.

MAE/MFE shown in

Show excursion values in currency or in futures ticks across analytics and the Trade Log.

Date format

DDMMYY, MMDDYY, or YYMMDD. It applies to Last traded, account details, reviews, chart labels, search, and history, and open views refresh when you change it. Stored timestamps and note filenames do not change.

24-hour time

Show times as 14:30 instead of 2:30 PM. Seconds are kept when a time has them.

First day of the week

The day your trading week starts on. It decides how weekly reviews and reports are grouped.

When MAE/MFE shown in is set to ticks, eligible futures trades are recalculated for display without changing saved trade data. Trades without valid tick size, tick value, or contract data are excluded from tick aggregates rather than mixed with currency values. How you enter MAE and MFE is part of the trade form.

Appearance and navigation

Appearance and navigation page showing Accent colour set to Journalit accent, Home background with a Choose image button, Use background on Dashboard, and Home settings for Your name, Open Home on startup, and Recent items

Accent colour

Journalit uses a lime accent by default. Choose Follow Obsidian's accent to use Obsidian's own. An accent set in Obsidian's Appearance settings or by a theme always takes over.

Home background

Choose an image to sit behind your Home widgets, and optionally reuse it in Dashboard mode.

Widget opacity

How solid widget backgrounds are over a background image. Light and dark themes keep separate values.

Your name

The name Home greets you with.

Open Home on startup

Open Home and focus it on startup, open it only when no file is active, or never open it automatically.

Recent items: Journalit files only

Restrict the Recent Items widget to files inside the journal folder when you want a trading-focused landing page.

Sidebars

Reveal the Navigation sidebar or the Calendar sidebar now, expanding Obsidian's own sidebar if it is collapsed.

Related page

See Navigation Sidebar for the full sidebar workflow, including search and customisation.

Opening links

The Opening links group on the Appearance and navigation page decides where things open.

Open trade after creating

Open new trade notes in a tab as soon as they are created.

Navigation opens in

Open views and reviews from Journalit's sidebars in a new tab, or replace the active one.

Review links open in a new tab

Open links inside review widgets in new tabs. When off, they replace the current tab.

Privacy

Privacy Mode

Mask sensitive trading, account, price, and performance values across the interface without changing saved data.

Hide dollar amounts in shared images

With R-multiples on, trade screenshots and review share cards leave out risk, fees, commissions, and MAE/MFE in dollars. The review share composer has the same checkbox.

Privacy Mode is a presentation setting, so turning it on does not alter data, sync, or calculations. The Privacy row on the Preferences page shows whether it is on.

Notifications

After updating

Show a short release highlight after an update installs, with a Learn more link to the full release notes inside Obsidian.

When an update is available

Check for new versions once a day and remind you when one is available. Turn it off to see only the release highlight after you update.

Files and backups

Files and backups keeps structural controls and recovery tools away from day-to-day setup.

Journal folder and image paths

Journal folder location

Choose where Journalit stores journal content. Leave it empty to use the default root folder.

Update image paths

Rewrite image paths in existing trades to match the current folder location. Run this after moving the journal folder by hand.

Backup, restore and reset

Export settings

Download all plugin settings as a JSON file for backup or transfer to another vault.

Import settings

Restore settings from a previously exported file. Imported values are merged with current ones.

Reset to defaults

Return every setting to its default. A backup is created automatically first.

Reset removes more than preferences

Resetting also clears custom options, account settings, and layouts. Export first if there is any chance you will want the configuration back.

Media Gallery

Add vault folders when the Trade Log Gallery should include media that is not attached to a trade or review note. Journalit scans configured folders recursively for supported images, video, GIFs, and Excalidraw files. Nested configured folders are deduplicated.

Best Practices

Set the foundations first

Configure currency, journal folder, date and time format, and the trading day cutoff before building a large archive.

Keep your taxonomy tight

Do not create overlapping setups, tags, or mistakes unless they support a real analysis distinction.

Treat Trade Sync as an operations surface

Use the status cards, error reports, and account-linking tools instead of assuming sync problems are solved by toggling one switch.

Back up settings before major changes

Export settings before restructuring layouts, custom fields, or sync-related configuration.

Bottom line

Settings defines your connections, journal structure, calculation rules, and everyday preferences in one place.