WorthTrack User Docs

Privacy Proof

For a plain-English explanation of WorthTrack's local-first data handling, optional AI workflows, permissions, and user-controlled backups, read the WorthTrack Privacy Proof.

AI Setup in Settings

Where: Settings and AI-related sections in the app.

Recommended setup order:

1. Open Settings and turn on AI features only if needed.
2. Select your preferred AI provider from available options.
3. Enter and save your provider API token or key.
4. Set model, report frequency, and content preferences.
5. Run a quick test report and verify output quality before regular use.

Tip: Keep your API key private, rotate keys if exposed, and remove unused provider keys.

How AI Reporting Works

Where: AI Reports.

AI reporting uses your selected in-app data context to generate summaries such as:

• Net worth trend commentary
• Budget vs actual behavior highlights
• Goal progress observations
• Portfolio and market context notes
• Actionable monthly review points

For best results, keep categories clean, update balances regularly, and review statement imports before report generation.

AI Statement Import (Optional)

Where: AI statement import flow and related report tools.

Use this when you want AI assistance extracting transaction content from statements you choose to import.

• Import the file you want to process
• Review extracted values before saving
• Correct dates, descriptions, or categories if needed
• Save and re-check totals against the statement

Always verify imported values before relying on reports or tax outputs.

Bank Statements: CSV Export Options

Where: Bank Statements and statement history areas.

WorthTrack supports CSV export to help with reconciliation, analysis, and sharing with accountants.

• Export the current statement list for the selected account and month.
• Export transaction rows after review and corrections.
• Export data for external review in spreadsheet tools.

Recommended CSV workflow:

1. Select the correct account.
2. Confirm the month key (for example 2026-05).
3. Review transaction dates, amounts, descriptions, and categories.
4. Export CSV and store with your monthly records.
5. Use the same file for accountant review or audit trails.

Tip: Keep one CSV per account per month for the cleanest history.

Bank Statements: Field Guidance

To keep exports and reports accurate, validate these fields before saving or exporting:

• Account name and account type
• Statement month key
• Transaction date format consistency
• Signed amounts (income vs expense)
• Description cleanup for duplicate or unclear payee text
• Category assignment for budgeting and reporting

Sample CSV Column Format

Example structure used for statement exports (column names may vary slightly by app version):

account_name,month_key,transaction_date,description,category,amount,currency,type,source

Example row:

ANZ Savings,2026-05,2026-05-04,Coffee Shop,Food & Dining,-6.50,USD,expense,statement_import

Best practice: keep one untouched original export, then create a working copy for spreadsheet edits.

Tax Guide Overview

WorthTrack tax supports:

• Tax country presets: NZ, US, AU
• Tax year filtering
• Cost basis methods: FIFO, LIFO
• Long-term threshold with Long-Term Days
• Buy lot tracking and sell or disposal tracking
• Dividend and interest event tracking
• Tax credits: withholding, franking, other
• CSV and PDF export

Quick Setup (Recommended Order)

1. Set Tax Country
2. Confirm Cost Basis Method
3. Confirm Long-Term Days
4. Add Buy Lots
5. Add Disposals
6. Add Dividend and Interest Events (if needed)
7. Review Tax Summary
8. Export CSV or PDF Statement

Tax Country

Where: Tax screen, Tax Country section.

Options: NZ, US, AU.

Country presets affect tax-year start month and default estimate rates.

Cost Basis Method

Where: Tax Country section (FIFO or LIFO).

• FIFO: first units bought are first units sold.
• LIFO: latest units bought are first units sold.

Different lot matching changes realized gain or loss outputs.

Long-Term Days

Where: Tax screen, Long-Term Days.

This sets the holding-period threshold used for short-term vs long-term classification. Example: 365 means holdings older than 365 days are treated as long-term in the model.

Lot Tracking (Buys)

Where: Tax screen, Lot Tracking (Buys).

Fields: Asset Name, Category, Quantity, Unit Cost, Fees, FX Rate to Base, Buy Date.

• Add a separate lot for each distinct buy date or price.
• Include fees and realistic FX rates for better accuracy.
• Tap Add Buy Lot after each entry.

Disposals (Sells)

Where: Tax screen, Disposals (Sells).

Fields: Asset Name, Category, Quantity Sold, Unit Proceeds, Fees, FX Rate to Base, Method, Withholding Tax, Franking Credit, Other Tax Credit, Sell Date.

Disposals are matched to available lots using selected method. Gain or loss is proceeds minus matched cost basis minus fees.

Add Tax Event (Manual)

Where: Tax screen, Add Tax Event.

Types: CAPITAL_GAIN, DIVIDEND, INTEREST.

Use this for manual adjustments, backfilling older records, or income not entered via lot and disposal flow.

Tax Year and Export

Where: Tax screen, Tax Year and Export.

• Select reporting tax year
• Export CSV
• Export PDF

Recommended workflow: select target year, confirm data completeness, then export and share with your accountant.

Tax Summary Definitions

• YTD Realized Gains: net realized gains or losses for selected year
• YTD Dividends: dividend income for selected year
• YTD Interest: interest income for selected year
• Carry-forward Loss: prior-year net losses carried into current-year estimate
• Estimated Tax Due (YTD): modeled estimate after rates and credits
• Estimated Tax on Unrealized: potential exposure if unrealized gains were realized

Frequently Asked Questions

Data Quality Checklist Before Export

• All buys entered as lots
• All sells entered as disposals
• Dates accurate
• Fees entered
• FX rates entered
• Tax country and method correct
• Correct tax year selected

Best Practices

• Enter transactions promptly (monthly at minimum)
• Avoid merging many buys into one lot unless truly identical
• Reconcile quarterly with statements
• Keep PDF exports per tax year as an archive