For the complete documentation index, see llms.txt. This page is also available as Markdown.

ROI Studio Troubleshooting

ROI Studio includes validation and dependency protection to help prevent changes that could leave your ROI Model with incomplete calculations, broken references or invalid configuration.

This guide covers confirmed messages and restrictions you may encounter while building or editing a model.


Formula Cannot Be Saved

You may see:

Please confirm the formula.

This can occur when saving a:

  • Std Formula Output;

  • Card Formula Output;

  • Gauge Formula Output.

The message indicates that the component does not currently contain a valid Formula.

What to check

Review the Formula and make sure:

  • a Formula has been entered;

  • all required values and references are present;

  • the Formula is valid;

  • there are no unresolved Formula errors.

ROI Studio prevents the component from being saved while its Formula contains an error.

For more information, see Creating & Editing Formulas and Formula Reference.


Table Formula Cannot Be Saved

When working with a Table Formula Output, you may see:

Please confirm the formula on table.

This indicates that an Equation cell contains a Formula error.

What to check

Expand the Table settings and review the Equation cells.

Correct any invalid calculations before saving the Table.

A Table can also be prevented from saving when:

  • a Visibility Condition is enabled without a source;

  • Dynamic rows is enabled without selecting Row count from.


List Choices Are Incomplete

When configuring a choice-based Input, you may see:

Please fill all list field.

This validation applies to components including:

  • Radio Button Input;

  • Dropdown Input;

  • Multi Select Input.

Review the configured choices and make sure the required choice information has been completed.

Once the incomplete choice fields have been corrected, try saving the component again.


A Component Cannot Be Deleted Because It Is Used in a Calculation

You may see:

Cannot delete! This component is used in in other components for calculations.

This means another component depends on the Input or Output you are attempting to delete.

Deleting it would leave another Formula referring to a component that no longer exists.

How to resolve it

Identify the dependent calculation and remove or replace the reference first.

Once the component is no longer being used by another calculation, you can delete it.

ROI Studio highlights dependent components to help you identify where the reference is being used.


A Component Cannot Be Deleted Because It Controls Visibility

You may see:

Cannot delete! This component is used in other components for the visibility.

This means the component is being used as the source of another component's Visibility Condition.

How to resolve it

Find the component using the visibility dependency.

Then either:

  • remove its Visibility Condition; or

  • change the condition to use another appropriate source.

Once the original component is no longer required by the condition, it can be deleted.


A Component Cannot Be Deleted Because It Controls Page Visibility

You may see:

Cannot delete! This component is used for the visibility of pagination.

This means the component is being used by the Visibility Condition of a page in a multi-page Calculator.

How to resolve it

Review your page configuration and identify the page using the component.

Remove or change the page Visibility Condition before deleting the referenced component.

This prevents a page from retaining a condition that refers to a component that no longer exists.


A Container Cannot Be Deleted

You may see:

Cannot delete! Columns/Accordion/Micro Tabs contains elements cannot be deleted.

Columns, Accordions and Micro Tabs can contain other model elements.

ROI Studio prevents the parent container from being deleted while it still contains components.

How to resolve it

Use the Navigator to review the structure of the model.

Move or remove the components contained within the parent element first.

Once the container no longer contains elements, try deleting it again.

See Reordering & Layout with the Navigator for more information.


A Component Cannot Be Moved to a Page

You may encounter:

Cannot move! Before that, Setup the pagination

This occurs when an action requires multi-page configuration but the required pagination structure has not yet been set up.

How to resolve it

Configure the model's pages first.

Once multi-page navigation has been established, assign or move the component to the appropriate page.

See Multi-page Calculators for more information.


Visibility Is Enabled but the Component Cannot Be Saved

When Visibility Condition is enabled, ROI Studio requires a source for the condition.

If the condition has not been fully configured, the component may not be saved.

What to check

Review the Visibility Condition and make sure the required source has been selected.

A typical Visibility Condition requires:

  • a source;

  • an operator;

  • a comparison value.

Complete the condition or disable Visibility Condition if it is not required.


Hidden Output Is Still Being Calculated

A hidden Output does not necessarily stop participating in calculations.

For supported Outputs, Calculate on Hidden determines whether the calculation continues while the component is hidden.

If an Output is hidden but its value is still affecting another result, check its Calculate on Hidden setting.

Visibility and calculation behaviour are separate.

See Conditional Visibility & Calculate on Hidden for a detailed explanation.


Dynamic Table Rows Are Not Working

When Dynamic rows is enabled on a Table Formula Output, you must select:

Row count from

This determines which Input or eligible Output controls the number of displayed rows.

The Table cannot be saved with Dynamic rows enabled but no controlling source selected.

Also make sure the Table contains enough configured rows for the maximum number you want to display.

Dynamic rows control how many existing rows are visible; they do not create unlimited new rows automatically.


Changing a Table Column Removed Its Values

Table columns can be configured as:

  • Text;

  • Equation.

Changing an existing column from one type to the other clears the existing contents of the cells in that column.

Review any existing values before changing the column type.

If you need to preserve information, make a note of the existing contents before making the change and then recreate the required values using the new column type.


Chart Preview Is Not Displayed

For segment-based Charts, you may see:

No Chart preview to display You need 2 or more data sources.

This applies when there are not enough data sources to create a meaningful Chart preview.

Add the required additional data source and configure its Formula.


Chart Cannot Be Saved

A Chart requires a Chart Title.

If the title is empty, the Chart cannot be saved.

Formula or series configuration errors can also prevent saving.

What to check

Make sure:

  • Chart Title has been completed;

  • required Legends have been entered;

  • required data sources have Formulas;

  • Chart Formulas are valid.

Resolve the incomplete configuration before saving the Chart.


Unable to Change to a Different Chart Type

After a Chart has been created, Chart type changes remain within the same Chart family.

You can change between:

  • Pie Chart;

  • Bar Chart;

  • Polar Area Chart.

You can also change between:

  • Line Chart;

  • Area Chart.

You cannot directly change a saved segment-based Chart such as Pie into a series-based Chart such as Line.

If you require a Chart from the other family, create the appropriate Chart instead.


Unable to Swap a Component Type

Not every ROI Studio component supports Swap component type.

Confirmed interchangeable groups include:

Current type
Available alternatives

Std Formula Output

Card Formula Output, Gauge Formula Output

Card Formula Output

Std Formula Output, Gauge Formula Output

Gauge Formula Output

Std Formula Output, Card Formula Output

Range Slider Input

Numerical Input, Dial Input

Numerical Input

Range Slider Input, Dial Input

Dial Input

Range Slider Input, Numerical Input

Radio Button Input

Dropdown Input

Dropdown Input

Radio Button Input

Some components do not support type swapping.

These include:

  • Multi Select Input;

  • Toggle Yes / No;

  • Table Formula Output;

  • Chart;

  • Columns;

  • Accordion;

  • Micro Tabs;

  • Dynamic Value Text;

  • Headers.

If Swap component type is unavailable, create the required component type instead.


A Gauge Is Displaying as a Percentage

This is expected behaviour.

Gauge Formula Outputs are designed specifically for percentage-style results.

A Gauge uses:

  • percentage formatting;

  • % suffix;

  • a 0–100 presentation scale.

Although other format options may be visible in the editor, the Gauge remains percentage formatted.

If the result should instead be displayed as currency, time or a general number, use a Std Formula Output or Card Formula Output.


Attached Resources Are Not Available

Attached Resources are available only on supported components.

Confirmed support includes:

  • Dynamic Value Text;

  • Std Formula Output;

  • Card Formula Output.

They are not available on:

  • Gauge Formula Output;

  • Table Formula Output;

  • Chart.

If the Attached Resources option is not available for the component you are editing, use a supported component where appropriate.

See Attached Resources for more information.


Import Metric Shows No Reusable Models

When selecting Import Metric, you may see:

No Reusables detected

Import Metric works with Calculators that have been made available as Reusable Models.

If none are available, create or convert an appropriate Calculator using:

Convert to Reusable Model

You can then return to ROI Studio and use Import Metric.

See Importing a Metric for the complete workflow.


An Imported Metric Does Not Match the Current Business Case

Imported Metrics are reusable calculation foundations.

They are not automatically tailored to every Calculator into which they are imported.

After importing a Metric, review its:

  • Inputs;

  • assumptions;

  • Outputs;

  • Formulas;

  • labels;

  • presentation.

Adjust the imported content where necessary for the business case you are creating.

Imported Metrics become independent content within the destination Calculator, so they can be refined without changing the original Reusable Model.


When Something Cannot Be Deleted

If ROI Studio prevents an Input or Output from being deleted, first consider whether it is being used elsewhere.

The component may be referenced by:

  1. another Formula;

  2. a component Visibility Condition;

  3. a page Visibility Condition;

  4. a containing layout component.

Removing the dependency first allows the model structure to remain valid when the component is subsequently deleted.

The Navigator can help you understand where components sit within the model structure.


When Something Cannot Be Saved

If a component's Save action is unavailable, review the configuration before recreating the component.

Common confirmed causes include:

  • an invalid Formula;

  • a missing Formula;

  • incomplete list choices;

  • Visibility Condition enabled without a source;

  • Dynamic rows enabled without Row count from;

  • Chart Title missing;

  • incomplete Chart series or data configuration.

ROI Studio uses these validations to prevent incomplete component configuration from being added to the model.


  • Creating & Editing Formulas

  • Formula Reference

  • Editing, Copying & Deleting Elements

  • Conditional Visibility & Calculate on Hidden

  • Reordering & Layout with the Navigator

  • Multi-page Calculators

  • Input Components

  • Output Components

  • Tables & Charts

  • Attached Resources

  • Importing a Metric

Last updated