Platform guide
This guide shows you how to upload a portfolio to the Integrum ESG Platform as a CSV file, share it with colleagues and keep it up to date. Portfolios can also be uploaded directly from your own systems through our API, as set out at the end of this guide.
Step 1: Prepare your file
Set out your file in Excel like this:
| Cell A1 | The portfolio name |
|---|---|
| Cell B1 (optional) | NON-AGGREGATE, to keep repeat ISINs as separate positions |
| Column A, from row 2 | The holding name |
| Column B, from row 2 | The ISIN or LEI |
| Column C, from row 2 | The weighting, with no % symbol |
Then save the file as CSV (comma delimited).
Good to know
- Weightings do not need to add up to 100. They are recalibrated automatically.
- Leave column C empty for equal weightings. Do not enter 0.
- Enter short positions as negative weightings.
- Do not add column headings, blank rows or notes.
Step 2: Open the upload page
- Click your initials in the top right corner.
- Select Portfolios & Profiles.
- Click Upload Portfolio.
Step 3: Upload the file
- Choose By ISIN or By LEI, to match your file.
- Drop your CSV into the upload box, or click the box to choose it.
- Check the file name under Files to be uploaded.
- Click Upload Portfolios.
Step 4: View your portfolio
- Wait for the message confirming the upload.
- Click Portfolio View in the left-hand sidebar.
- Choose your portfolio from the Portfolios drop-down.
The overview shows how much of the portfolio is covered directly, how much uses proxy scores and how much is not covered. Use the Include proxy scores toggle to switch proxy scores on or off.
The tabs below the overview open each dataset: ESG Overview, Material Risks, Footprint, Global Warming Impact, Regulatory and Revenue Data. The methodology behind each one is on our Methodologies and Tutorials page.
Step 6: Update a portfolio
To change weightings or add holdings:
- Click the three dots next to the portfolio.
- Select Update Portfolio.
- Upload a file in the same layout, without the portfolio name in cell A1.
To replace a portfolio completely, including removing holdings:
- Upload a new file with the same portfolio name in cell A1. The portfolio is refreshed to match the new file.
To change a portfolio’s name, select Rename Portfolio from the same menu.
Upload portfolios through our API
Your technology team can upload portfolios directly from your own systems, so holdings stay current without manual uploads.
- Send the same CSV layout, with ISINs in column B, to our portfolio upload endpoint, authenticated with your API key.
- Each response confirms the upload and lists any ISINs that could not be mapped, so they can be corrected at source.
- API keys are created by Super Users on the Account page, as explained in our guide to managing your account and team.
- The API Portfolio Management guide sets out the request format in full, and the API Guide covers the wider API.
Frequently asked questions
What file format do I need?
A CSV (comma delimited) file, with the portfolio name in cell A1 and, from row 2, the holding name in column A, the ISIN or LEI in column B and the weighting in column C.
Do weightings need to add up to 100?
No. Weightings are recalibrated automatically. Leave column C empty for an equally weighted portfolio.
Can I upload short positions?
Yes. Enter short positions as negative weightings.
Can I upload by LEI instead of ISIN?
Yes. Choose By LEI on the upload page to match the identifiers in your file.
What happens to holdings that are not covered?
The portfolio overview shows the share of the portfolio covered directly, the share shown using proxy scores and the share not covered. Proxy scores can be switched on or off, as explained in our Proxy ESG Scores Methodology.
Can I upload portfolios directly from my own systems?
Yes. Your technology team can send portfolio files to our API, authenticated with an API key, so holdings stay current without manual uploads. The API Portfolio Management guide sets out the request format.
More Platform guides
Related methodologies
Prefer a walkthrough?
Your Account Manager can take you through this on a short call and answer any questions as you go. You can also email contact@integrumesg.com.

