Investment Tagging & Defaults

​

Overview

Investment tagging allows you to label and categorise your investments beyond the standard category structure. Tags provide flexible slicing across your portfolio without changing your core investment organisation. When combined with tag defaults at the category and subcategory level, tags automatically apply to investments, saving time and ensuring consistency.

​

Core Concepts

​

Tag Groups

A tag group is a dimension or characteristic you want to track across investments. Examples include:

• Liquidity: Liquid, Illiquid
• Strategy: Growth, Value, Income
• Risk Level: Low, Medium, High
• Source: Direct, Fund, Trust

Tag groups can be configured as:

• Single-select: Choose one option per group (e.g., Liquidity: Liquid or Illiquid)
• Multi-select: Choose multiple options per group (e.g., Strategy: Growth, Value, Income)

​

Tag Options

Tag options are the specific values within each tag group. For example, the “Liquidity” group might have options: “Liquid”, “Illiquid”, “Semi-Liquid”.

​

Tag Defaults

Tag defaults are predefined tag assignments that automatically apply to investments based on their category or subcategory. This eliminates the need to manually tag each investment and ensures consistency across your portfolio.

​

Inheritance Hierarchy

Tags cascade through your investment structure:

1. Category defaults → Apply to all investments in that category
2. Subcategory defaults → Override or add to category defaults
3. Investment overrides → Override inherited defaults for specific investments

​

Getting Started

​

Step 1: Create Tag Groups

1. Navigate to Settings → Investments → Tags
2. Click “New Group”
3. Enter a name (e.g., “Liquidity”)
4. Choose Selection Type:
   • Single-select: For mutually exclusive options
   • Multi-select: For combinable labels
5. Optionally add a description and order number
6. Click “Create”

​

Step 2: Add Tag Options

1. In your tag group card, find the Options section
2. Use the inline input field to add options
3. Type an option name (e.g., “Liquid”) and press Enter or click “Add”
4. Add additional options as needed (e.g., “Illiquid”, “Semi-Liquid”)
5. You can rename options by clicking the “Rename” button

​

Step 3: Set Category Defaults

1. Navigate to Settings → Investments → Categories
2. Expand a category by clicking on it
3. In the “Category tags” section, you’ll see all your tag groups
4. For each tag group, select the default option that should apply to all investments in this category
5. The selection saves automatically

Example: If you set “Liquidity: Liquid” as a default for the “Equities” category, all equity investments will automatically be tagged as “Liquid” unless overridden.

​

Step 4: Set Subcategory Defaults (Optional)

1. Still in Settings → Investments → Categories
2. Expand a category and find the “Subcategories” section
3. For each subcategory, you’ll see tag controls
4. Tags can show as “Inherited” (from the category) or be set specifically for the subcategory
5. Select a specific option to override the category default, or leave it as inherited

​

Step 5: Override at Investment Level (Optional)

1. Navigate to an investment’s detail page
2. Go to the “Investment information” section
3. Find the “Tags” section
4. Click “Edit” to enter edit mode
5. Select the desired options for each tag group
6. Save your changes

When to override: Use investment-level overrides when a specific investment doesn’t fit the category or subcategory default. For example, if most equities are “Liquid” but one specific equity is “Illiquid”.

​

Using Tags in the Dashboard

Tags provide powerful filtering capabilities in your organisation dashboard, allowing you to focus on specific subsets of your portfolio.

​

Accessing Tag Filters

1. Navigate to your Dashboard
2. Click “Show filters” to expand the filter panel
3. You’ll see filter dropdowns for each tag group you’ve created

​

Filtering by Tags

1. In the filter panel, locate the tag group you want to filter by
2. Select an option from the dropdown (e.g., “Liquid” from the “Liquidity” group)
3. The dashboard automatically updates to show only investments matching that tag
4. You can combine tag filters with other filters (Entity, Category, Subcategory, Listed Status)

​

Benefits of Dashboard Tag Filtering

• Quick Portfolio Views: Instantly see all liquid investments, or all high-risk investments
• Comparative Analysis: Compare performance across different tag dimensions
• Focused Metrics: View key metrics (market value, cost basis, gains) for filtered subsets
• Category Allocation: See how tagged investments are distributed across categories
• Currency Exposure: Understand currency breakdown for filtered investments

​

Active Filter Display

When filters are active, you’ll see badges at the top showing:

• Applied tag filters (e.g., “Liquidity: Liquid”)
• Other active filters (Entity, Category, etc.)
• Click the X on any badge to remove that filter
• Click “Clear all” to remove all filters

​

Using Tags in Reports

Tags integrate seamlessly with the reporting system, allowing you to generate targeted reports for specific investment subsets.

​

Adding Tag Filters to Reports

1. Navigate to Reports
2. Create a new report or edit an existing one
3. In the report configuration, find the Filters section
4. Under Tags, you’ll see controls for each tag group
5. Select one or more options from each tag group
6. The report will only include investments matching the selected tags

​

Tag Matching in Reports

Reports currently use ANY matching mode:

• If you select multiple options from the same group, investments matching any of those options are included
• If you select options from different groups, investments must match at least one option from each group

Example:

• Filter: “Liquidity: Liquid” AND “Strategy: Growth”
• Result: Shows investments that are both Liquid and Growth

​

Report Benefits

• Regulatory Reports: Filter by tags to generate reports for specific compliance requirements
• Performance Analysis: Compare returns across different tag dimensions (e.g., liquid vs illiquid)
• Risk Reporting: Generate reports focused on high-risk or low-risk investments
• Entity-Specific Views: Combine tag filters with entity filters for entity-level reporting

​

Best Practices

​

Tag Group Design

​

Default Strategy

​

Maintenance

​

Common Use Cases

​

Liquidity Management

Use Case: Quickly identify which investments can be easily converted to cash. Set “Liquid” as the default for listed equities, and “Illiquid” for private investments.

​

Strategy Classification

Use Case: Classify investments by investment strategy. An investment can have multiple strategies (e.g., both Growth and Income).

​

Risk Assessment

Use Case: Tag investments by risk level for compliance reporting and risk management analysis.

​

Troubleshooting

​

Tags Not Appearing on Investments

Problem: An investment doesn’t show any tags. Solutions:

• Ensure a default tag exists on the investment’s category or subcategory
• Check if the investment has an explicit override set (which might be empty)
• Verify the tag group and options still exist (deleted groups/options won’t appear)

​

Filter Returns No Results

Problem: Applying tag filters shows no investments. Solutions:

• Remove other filters to see if they’re conflicting
• Check that investments actually have the tags you’re filtering for
• Verify the tag defaults are set correctly for the categories/subcategories
• Try selecting “All” for other filters to isolate the tag filter

​

Inherited Tags Not Showing

Problem: Subcategory shows “Inherited” but the tag doesn’t appear on investments. Solutions:

• Verify the category default is set correctly
• Check that the investment is actually assigned to that subcategory
• Ensure no investment-level override is clearing the tag

​

Can’t Delete Tag Group/Option

Problem: Unable to delete a tag group or option. Solutions:

• Confirm the deletion prompt; this action is irreversible
• Be aware that deleting will remove the tag from all investments, categories, and subcategories
• Consider reassigning investments to alternative tags before deleting

​

Advanced Tips

​

Combining Filters

Tags work best when combined with other dashboard filters:

• Entity + Tag: See all liquid investments for a specific entity
• Category + Tag: Compare risk levels within a category
• Listed Status + Tag: Analyse listed vs private investments by liquidity

​

Report Templates

Save report configurations with tag filters as templates:

1. Create a report with your desired tag filters
2. Save it as a template
3. Reuse the template for regular reporting without reconfiguring filters

​

Bulk Tagging

While individual investment overrides are supported, the power of defaults means you rarely need to tag investments individually:

• Set defaults at the category level for broad coverage
• Use subcategory defaults for more granular control
• Only override specific investments when they truly differ

​

Summary

Investment tagging with category and subcategory defaults provides a powerful, flexible way to organise and analyse your portfolio:

• Automatic Organisation: Defaults ensure consistent tagging without manual work
• Flexible Filtering: Filter dashboards and reports by any tag combination
• Inheritance: Subcategories inherit category tags, reducing duplication
• Overrides: Individual investments can override defaults when needed
• Analytical Power: Tags enable insights that go beyond standard categories

By setting up tag defaults strategically, you can maintain a well-organised portfolio that’s easy to filter, analyse, and report on, all while minimising manual tagging effort.