v3.94: Editing Custom Holdings in Client Portfolios

Koyfin -

You can now edit the attributes of a custom holding inside a Client Portfolio account. For manually created accounts, you can also add a custom holding from scratch.
Set how a holding is named and classified so it groups correctly across the account's exposure and reports. This is useful when a holding imported from a custodian, CSV, or PDF does not match a security in Koyfin.
You can manage these settings from the Custom Holdings tab in the account's Edit Account window.

Custom Holdings

Custom holdings are securities that are not recognised in the Koyfin system. Examples can include corporate bonds, private funds, artwork, employee-stock options, and more.

Rather than ignore them, Koyfin portfolios create a custom holding — a placeholder that keeps your portfolio data intact, allowing you to represent the cost, value, weighting, and attributes (such as asset class, currency, instrument type) of your holding.

Custom holdings can be created as a result of imported data for:

  • A custodial or portfolio management service integration;
  • A PDF broker statement upload, or;
  • A CSV statement upload

You can also create custom holdings from scratch in any manually created account.

The Custom Holdings tab

  1. In Client Portfolios, open the account and click Edit Account.

2. Select the Custom Holdings tab. It lists the account's custom holdings, each with an Attributes button on its row.

Editing a holding

  1. Click Attributes on the holding's row to open the panel.
  2. Edit the holding's Display Name, Asset Class, Instrument Type, and Currency. Asset Class options are Equity, Fixed Income, Cash, Alternatives, Convertible, Preferred, and Other.
  3. Click Save Account to apply your changes.

The Display Name controls how the holding appears across the account's views and reports. On accounts synced from an integration, the holding's original imported name stays visible above the Display Name.

You can remove a custom holding by clicking the trash icon on its row (see image attached below).

Adding advanced attributes

Click Advanced Attributes at the bottom of the panel to expand a second set of fields. All fields are optional and allow the holding to be included in calculations and breakdowns that require this data:

  • Dividend / Distribution Yield and Expense Ratio contribute to the account's weighted yield and weighted expense ratio, and appear in the Profit/Loss table, Top Holdings, and report Key Stats.
  • Credit Rating, Maturity, and Fixed Income Sector are used in the corresponding exposure exhibits.
  • Duration applies to fixed income holdings.
  • Country and Region apply to holdings classified as Equity or Fixed Income.

These attributes describe the holding. They do not create price history or performance data for it.

Creating a custom holding

You can create custom holdings in accounts that were created manually or imported from a CSV or PDF.

  1. Click + Add Custom Holding in the Custom Holdings tab.
  2. Enter the Ticker, Display Name, Asset Class, Instrument Type, Last Price, and Currency.
  3. Add any advanced attributes as needed, then click Create Account.

The Alternatives asset class

We have added a new Asset Class, Alternatives, to the list of selectable asset classes.

Holdings classified as Alternatives appear:

  • As a separate category in the Asset Allocation exposure exhibit.
  • In the Allocation % (Alternatives) and Relative to Benchmark % (Alternatives) columns on the Client Portfolios homepage, Model Portfolios homepage, and in Watchlists.

How edits behave on synced accounts

In accounts synced from an integration, the quantity, cost and purchase date are read-only, but you can still edit a custom holding's attributes. Any attribute you change will persist and is not overwritten when the account syncs. Attributes you leave unedited continue to update from the integration. In accounts created from scratch, CSV or PDF, you can also edit the Ticker.

Where your changes show up

Altering any custom holding attribute will reflect those changes downstream across exposure exhibits, reports, the profit / loss analysis table, and so on.

For example, if a corporate bond was imported as a result of a custodial integration with the asset class "Other", changing this asset class to "Fixed Income" will mean that this holding is now represented in the Fixed Income exposure across asset class exposures, and in reports.