Background decoration

Menu

Docs
Wealthfolio User Guide

Wealthfolio User Guide

Comprehensive guide on using Wealthfolio to track and manage your investments.


This guide will walk you through the main features of Wealthfolio and how to use them effectively.

Initial Setup

Set Your Main Currency

  1. Go to the settings/General tab.
  2. Choose your preferred currency from the list provided.
  3. Confirm your selection.

Add Your Accounts

  1. Navigate to the settings/Accounts tab.
  2. Click “Add Account” and fill out the form:
FieldDescription
Account NameEnter a descriptive name for your account
Account GroupEnter a group to organize your accounts (e.g. 401k, RRSP, Cash Savings)
Account TypeSelect from Securities, Cash, or Crypto
Account CurrencyChoose the currency for this account
Is DefaultCheck this box if you want this to be your default account
Is ActiveEnsure this is checked to include the account in your portfolio
  1. Click “Save” to add the account.
  2. Repeat for each account you want to track.

Managing Activities

Activities in Wealthfolio represent all your financial transactions, including buys, sells, dividends, deposits, withdrawals, and more. Properly managing these activities is crucial for accurate portfolio tracking.

Supported Activities

Wealthfolio supports the following activity types to track your investments:

Activity TypeDescriptionImpact
BUYPurchase securities or assetsDecreases cash, increases holdings
SELLSell securities or assetsIncreases cash, decreases holdings
DIVIDENDRecord dividend paymentsIncreases cash
INTERESTTrack interest incomeIncreases cash
DEPOSITAdd funds to accountIncreases cash
WITHDRAWALRemove funds from accountDecreases cash
TRANSFER_INImport external positionsIncreases holdings only
TRANSFER_OUTExport positions externallyDecreases holdings only
FEERecord account feesDecreases cash
TAXRecord tax transactionsDecreases cash

Supported Securities

Wealthfolio uses Universal Symbol objects, which can be identified by either a ticker or a Universal Symbol ID. When you input a ticker, the system returns the first matching result. We primarily adhere to the Yahoo Finance ticker format for consistency and accuracy.

Here are some examples to illustrate the ticker format:

  • For stocks traded on the Toronto Stock Exchange (TSX), append .TO to the ticker. For instance, RY.TO for Royal Bank of Canada.
  • For stocks traded on the London Stock Exchange (LSE), use .L at the end. For example, HSBA.L for HSBC Holdings.
  • Stocks traded on NASDAQ or NYSE typically don’t require a suffix. For example, AAPL for Apple Inc.

To ensure the most accurate results, always use the ticker with the appropriate suffix for the exchange where the security is traded. For comprehensive information about market coverage and potential data delays, please consult the Yahoo Finance Market Coverage documentation.

Adding Activities Manually

This method is ideal for entering one-off trades or transactions as they occur.

  1. Click on “Activities” in the main sidebar of the app.
  2. Click “Add Activity” to record a new transaction.
  3. Fill out the activity form:
    • Select the account from the dropdown menu.
    • Choose the activity type (BUY, SELL, DIVIDEND, INTEREST, DEPOSIT, WITHDRAWAL, TRANSFER_IN, TRANSFER_OUT, CONVERSION_IN, CONVERSION_OUT, FEE, TAX).
    • Set the transaction date and time.
    • Enter the symbol of the security (if applicable).
    • Input the quantity (number of shares or units).
    • Enter the unit price.
    • Select the currency.
    • Add any fees associated with the transaction.
  4. Review the entered information and click “Add Activity” to save, or “Cancel” to discard.

CSV Import

Wealthfolio provides a flexible CSV import feature that allows you to easily map your data fields and save mappings for future use:

  1. Ensure your CSV file includes column headers in the first row.
  2. Click on the “Import CSV” option
  3. Drop your CSV file or click to select it
  4. The import wizard will guide you through mapping your CSV columns:
    • Match your CSV columns to Wealthfolio fields (date, symbol, quantity, etc.)
    • Map your activity types to Wealthfolio’s supported types (BUY, SELL, DIVIDEND, etc.)
    • Map any non standard ticker symbol to ensure they match Yahoo Finance format.
  5. Review the mapped data preview, errors, and make any necessary adjustments.
  6. Save the mapping for this account to streamline future imports
  7. Confirm the import if everything looks correct

Your column mappings will be saved for the selected account, making future imports faster and more consistent.

CSV import Mapping

The application will also check the ticker symbols and notify you of any errors. You can filter the error and view the details by clicking on the error icon.

CSV import errors

Here is an example of default CSV format:

date,symbol,quantity,activityType,unitPrice,currency,fee
2024-03-01T15:02:36.329Z,MSFT,1,DIVIDEND,57.5,USD,0
2024-02-15T15:02:36.329Z,MSFT,30,BUY,368.6046511627907,USD,0
2024-06-05T09:15:22.456Z,$CASH-USD,1,INTEREST,180.5,USD,0
2024-04-02T11:20:15.321Z,$CASH-USD,1,WITHDRAWAL,1000,USD,0
2024-05-18T13:45:30.789Z,AAPL,5,SELL,210.75,USD,0
2024-01-07T09:10:20.987Z,MSFT,30,BUY,360.75,USD,9.99
2024-01-23T11:40:50.456Z,AMZN,15,BUY,170.00,CAD,9.99
2024-01-18T13:55:05.789Z,AAPL,1,DIVIDEND,50.25,USD,9.99
2024-01-11T15:10:20.321Z,AAPL,10,BUY,189.60,USD,9.99
2023-02-12T16:25:35.654Z,TSLA,20,BUY,212.50,USD,9.99
2023-01-15T12:10:20.456Z,SHOP,25,BUY,61.23,USD,9.99
2023-01-18T15:55:05.654Z,NVDA,12,BUY,52.40,USD,9.99
2023-03-11T14:55:30.863Z,$CASH-USD,100000,DEPOSIT,1,USD,0

Dashboards Overview

The dashboards provides a quick snapshot of your portfolio:

Total portfolio value and accounts breakdown

Wealthfolio Dashboard

Asset allocation

Wealthfolio Holdings

Income Dashboard

Wealthfolio Income

/>

Tracking Performance

  • View performance charts for individual investments or your entire portfolio.
  • Set up custom date ranges to analyze specific periods.
  • Monitor your overall gain/loss percentage and amount.

For more detailed information on specific features or troubleshooting, please refer to our FAQ section.

Tracking Contribution Limits

Wealthfolio helps you track your contribution limits for tax-advantaged accounts like IRAs, 401(k)s, or TFSAs. You can set contribution limits for each account and track your available contribution room. To do this:

  1. Go to the settings/Limits tab.
  2. Click on “Add Limit”.
  3. Create a the contribution limit with an identifiable name (e.g. 2025 RRSP or 2025 Roth IRA), Year and set the contribution limit in base currency.
  4. Save the limit
  5. Select all accounts you want to track for this limit and click “Save selected accounts”.
  6. You can now track your contribution limits and available contribution room in each account page or in the limits settings page.
Wealthfolio Contribution Limits