Get your records in / Uploads
When Margin cannot read your broker's file
Every upload in Margin starts by asking which brokerage the file came from, because each broker writes its own column headers, date format and wording for the same facts. Margin reads a file by matching it against a layout it has been shown. When you pick a broker for which no layout exists, the dialog says We cannot read a [broker] … statement yet. This page explains what sits behind that message and what to do about it, and the feature guides link here whenever they reach it.
What Margin reads today
| Upload | Read as downloaded | Through the Other layout |
|---|---|---|
| Holdings | Zerodha, Groww, Upstox, AngelOne | Yes, CSV |
| Trades | Zerodha, Groww, Upstox, AngelOne | Yes, CSV |
| Dividends | Zerodha | No |
| Funds statement | Zerodha | Yes, CSV |
“Read as downloaded” means the file goes in exactly as the broker’s console or app exported it. The Other layout is a fixed set of column headers that Margin publishes in the upload dialog, with a Download template button, for you to save a file into.
Why a broker is missing
In every case it is because Margin has not been shown that broker’s file format yet. A layout gets added once someone sends in a real export, so the list above grows one statement at a time.
A broker can also rename a column or change a date format between one year’s export and the next, and the first person to download the new version sees an upload refused. A changed format goes in through the same route as a new broker.
What to send
Margin needs the layout of the file and nothing that identifies you.
- The header row, exactly as the file has it.
- One or two data rows, with amounts, names and dates changed if you prefer. What matters is the position of each field and how the dates and numbers are written.
- Which upload it is for: holdings, trades, dividends or the funds statement.
- For an Excel export, the sheet name and the row the headers sit on, since these files often carry a title block above the table.
The trading accounts, client codes, bank references and payment descriptions that fill a real statement are not needed and are better left out.
How to send it
1. Feedback from inside the app
- Open the feedback form from the speech-bubble icon in the top bar of any page. The dividend upload dialog also has a Send the format button that opens the same form with the request already written.
- Pick I want something as the category.
- Paste the header row and a sample row into the message. The form takes text only, so paste the rows into it.
2. Email
Send the file, or the rows above, to support@marginapp.in. Use this route when you would rather share the whole export, since the feedback form has no attachment.
What happens next
The format is mapped on Margin’s side and the broker is added to the layouts the upload dialog knows. Nothing changes in your account until then, and nothing you sent is uploaded to your ledger. Once the broker is on the list, you upload the file as downloaded, the same as any supported brokerage.
Meanwhile, the Other layout
You do not have to wait for holdings, trades or the funds statement. Add a trading account with a brokerage of Other, open the upload dialog for it, and the Expected file format panel lists the columns. Save your broker’s export as a CSV with those headers and it goes in like any other file. Keep in mind that the Other account is a separate ledger from the broker’s own name, so once the broker is added you can either carry on with the Other account or move to a new one.
Dividends have no Other layout, so a dividend statement from a broker outside the supported list waits for its format to be added.
Where to go next
- The funds statement, net invested and charges walks through the funds upload, including the Other layout for it.
- Tradebook into Margin and Dividends into Margin cover the same uploads through the API, for agents.
Also under get your records in
Importing holdings and trades
How to bring your broker's holdings export and tradebook into Margin, what each file feeds, the generic CSV layouts for a broker Margin does not read yet, what a re-upload replaces and what it only adds to, and how to read the first errors.
The funds statement, net invested and charges
How to bring your broker's funds statement into Margin, what money in, money out and net invested each count, how to read the charges posted to your account, and why a missing year understates every total after it.
Dividends, by financial year and on the ex-date
How a dividend statement goes into Margin one financial year at a time, what re-uploading a year replaces, why the ex-date is the date kept, how each payout enters XIRR, and what to do with rows that match no stock.
The consistency check
How Margin reconciles your tradebook against your demat holding, names the splits and bonuses you never recorded, and why the gap it finds should be closed before you trust XIRR, gains or allocation.
Try Margin
Put this into practice
Margin gives you DCF valuation, Reverse DCF, XIRR and capital gains tracking in one place. Free, no credit card required.
Start for free