ReGraph Version 5

Enhancements

• Diacritics marks on Indic scripts are now supported.
• We've improved performance for organic, lens and sequential charts that contain nodes with a very large number of connections (10,000 connections and more).

• We have fixed a branding issue on our SDK site.

Enhancements

• We've significantly improved our combo algorithms. Especially in very large charts, this results in:
  • Smoother combo dragging and interactions with combos.
  • Higher frame rate of opening and closing of combos (up to 6x higher).
  • Higher frame rate when running a layout on top level combos (up to 5x higher).
• Organic layout charts with a small number of nodes are now more symmetrical.

Bugs Fixed

• Interacting with a chart after it has unmounted no longer produces an error.
• Passing an empty object to the setStyle function of onItemInteraction no longer causes issues.
• A sequential arrangement inside combos with a single level of nodes now always respects the orderBy property.
• Hovering over a combo item with interaction styling set by onItemInteraction while another combo is opening no longer produces an intermittent error.

Enhancements

• Sequential layout with automatically assigned levels is now up to 8x faster, particularly on large and densely connected charts.
• Charts with combos are now more performant, with biggest improvements achieved for very large charts. These improvements apply to multiple scenarios, including:
  • Opening and closing combos
  • Triggering a layout on combos
  • Adding items to existing combos
  • Re-setting the combine prop to a new object
  • Styling combos using the onItemInteraction event
• The delay before an animation starts for large charts is now significantly shorter.
• The frame rate of animations is now higher for large charts with hidden items (hidden from view or hidden within combos).

Bugs Fixed

• Position of labels with vertical position set to 'inherit' inside auto-sized nodes is always respected.
• Combos in sequential charts are spaced correctly from other items when opened and closed for the first time.
• The setStyle function of onItemInteraction now correctly applies color to aggregate links when a color is also defined in the setStyle function of onLinkAggregation.

End of Support

• Support for Windows 10 has now ended.

• View changes to charts with an integrated Leaflet map no longer draw links incorrectly in some situations.

• Fixed an issue where the Playground would sometimes require a hard reload to work correctly.
• Dragging nodes connected by links with a colour gradient no longer causes issues.

Enhancements

• We've improved the algorithms behind opening and closing combos, significantly reducing overlapping items when combos are repeatedly opened and closed.
• We've optimized the performance of nested combo arrangements, meaning they are now up to 10x faster.

Bugs Fixed

• When combos are opening or closing, the correct labels are always shown during the animation.
• When links with arrows have the linkShape property set to 'curved' they no longer produce a type error.

End of Support

• Support for LTA version 3.10.1 has now ended and the version has been removed.

• We have fixed an issue with our licensing mechanism.

Features

• Annotations can now be added without subjects and positioned anywhere on the chart. Standalone annotations can be customized in the same way as annotations with subjects, and they are especially useful for adding overall context to a chart.
• The annotationPositions prop now supports x and y world coordinates. This keeps world-coordinate annotations in place even when their subjects are added, moved or removed, or when the chart or view are changed.
• We've launched new MCP servers across our products to help AI agents in your code editor interact with our APIs and documentation. Use the ReGraph MCP server to get better assistance during ReGraph development, or add our MCP servers together when integrating multiple products. See the MCP Servers documentation for details.

Enhancements

• Curved links drawn over a long distance are now much smoother.
• The sequential layout with automatically assigned levels is now even faster at revealing hidden hierarchies in complex datasets with at least 1000 nodes.
• We've improved performance when setting new chart properties. This is especially noticeable when setting them during drag events or zoom events.

Bugs Fixed

• Having times property set on many chart items no longer causes performance issues.
• Clearing styles of removed combo links no longer causes unnecessary console warnings.
• A chart parent element with a decimal point in height or width dimensions no longer causes performance issues.
• The data property set on open combos using the setStyle function of the onCombineNodes event is now correctly returned by other event handlers.

Enhancements

• We've added a new Credit Card Fraud showcase where you can investigate and filter transactions to find the origin of a card skimming fraud.
• We've updated our Social Media Analysis showcase with a fresh new design and our latest styling features.
• We've made some refactoring improvements to annotations which have notably reduced the level of CPU usage during annotation animations.

Bugs Fixed

• The index.d.ts file in the ReGraph bundle no longer contains duplicate imports.

Advance notice: end of support for Windows 10

We are ending support for Windows 10 from 31 March 2026, following Microsoft ending support for Windows 10. See Supported platforms & browsers for details.

Bugs Fixed

• Setting data in the setStyle function of the onCombineLinks event now works as expected.

• SVG Data URLs are now loading image data correctly.
• The tightness values set for nested combos are now respected.
• Font icon rendering in very large charts no longer causes performance issues.
• Deleting an item foregrounded by selection removes the fade from unselected items.
• Conditionally setting summary and contents links for nested combos works correctly on first load.

Features

• The organic and lens layouts (and the lens arrangement for combos) are now better at reducing node label overlaps and creating a more readable chart. When tightness is set to values between 1 and 5, nodes with large labels are spread out more accurately to create fewer label overlaps without obstructions to the view. Explore the improved behavior in the Insurance Fraud Analysis showcase.

Enhancements

• We've improved the performance when selecting closed and open combos in very large charts.

Bugs Fixed

• Circle node and glyph borders are always exported correctly into SVG and PDF.

Features

• To make it easier to integrate icon font libraries into ReGraph, you can now pass the icon's ligature string directly in the text property of fontIcon.
• As a more modern approach to font loading, we are now using and recommending the document.fonts property from the CSS Font Loading API. We've implemented it in our examples, in the default Playground and also in the updated Fonts and Font Icons docs with brand new step-by-step tutorials.

Bugs Fixed

• Interaction styling for combo labels is now applied correctly during the onItemInteraction event.

Deprecations

• We've deprecated the FontLoader component using TypeKit's Web Font Loader and are planning to remove the component from the ReGraph package in the future. Use document.fonts from the CSS Font Loading API instead.

Features

• The border API controlling the glyph border styling now has a new width property to customize the border width. Explore the new API in the updated Node Gallery and Link Gallery, or see the redesigned Cyber Impact showcase with an enhanced alert system and interactive annotation glyphs.

Enhancements

• We've improved the performance of large charts with annotations. These improvements are especially notable for charts where annotations are linked to many subjects, and for annotated charts containing many nodes with text labels.

Bugs Fixed

• Width of annotation labels is now calculated correctly.
• Halos and donuts are exported correctly to SVG and PDF.
• Dashed borders on circle nodes are now always drawn correctly.
• Styles of removed items are always cleared without unnecessary console warnings.
• Dragging an annotation returns the correct annotation id in the onPointerMove event.
• The values in id1 and id2 properties of onLinkAggregation match the items at the ends of the aggregate link.
• The TypeScript definition for GlyphLabel now inherits from LabelBase and not the other way around. This corrects some wrongly expected default values for the color of the labels.
• The TypeScript definition of a watermark label is no longer of the Label type. Instead, it has its own WatermarkLabel definition, which inherits from Label and overwrites some default values.

• Rectangular items with rounded corners no longer show artefacts in some browsers.

• Fixed an issue where some pixels near a node label edge were incorrectly excluded from the interaction area.

In this release, we've focused on improving the way combos are animated and laid out alongside other chart items. As a result, combo animations are now smoother than ever, and combos are laid out in charts more neatly and efficiently.

Explore the improvements in our new Social Media Analysis showcase.

In another great improvement, you can now create even richer chart designs with our new link label styling APIs.

The border option customizes the color, width and radius of borders around your labels, while the padding option controls the distance between the label text and the label border.

For more details, see our updated Link, Link Gallery and Path Finding examples.

Enhancements

• Thanks to improved anti-aliasing for rectangular labels, sloping rectangular labels are now drawn with smoother edges.
• The organic layout is now even more efficient when adding items into large charts, resulting in less unnecessary movement and better performance.
• Our Figma Design Kit is now in General Availability and you can download the latest version here.
• The new changeEventThrottling time bar option lets you control the interval between individual onChange events.

Bugs Fixed

• We've fixed a number of issues related to the onItemInteraction event.
• Labels with minHeight set to 'stretch' are drawn correctly on auto-sized nodes and annotations.
• Annotation containers around subjects nested in combos are now animated correctly during combo animations.

• We recently launched the Cambridge Intelligence Figma Design Kit, which helps accelerate the design and build of your graph and timeline visualizations. It is now available to download here.

Enhancements

• We've refreshed our Advanced Node Gallery example with new node designs and our latest features to give you even more inspiration for node styling.
• Our angled links now support flow animation.
• Our aggregate links are now more performant in some situations including aggregating links between and within combos, foregrounding and fading aggregate links.
• The Getting Started docs now feature new npm, yarn and pnpm tabs which automatically display the right steps for your selected package manager.
• A new section in the Obfuscation Requirements docs clarifies your obligations with regards to any applicable Open Source Software (OSS) licenses.

Bugs Fixed

• Link ends now correctly avoid node labels with rounded corners.
• We've fixed a number of issues related to the onItemInteraction event.
• Navigation controls work as expected in charts with large number of images.
• Glyphs on nodes with certain node IDs are now positioned correctly on the node.
• Node and link labels with a specified labelOffset are now always exported as expected.
• Open combos containing nodes with width or height set to 'auto' now resize when the nodes change size.
• Links between combos are aggregated correctly when combo is open with animate set to false in the animation prop.

Features

• A new angled link shape provides an orthogonally branching link shape to help understand hierarchical relationships within tiered datasets. It is particularly suited to sequential layouts or arrangements, and is always aligned with their orientation property. See the Angled Links example.
• As well as setting link shape on a per-chart or per-combo basis, you can also now set it for individual links, using linkShape. This means that you can now use link shapes to represent different types of relationship in the same chart, as illustrated in the Mixed Link Shapes example.
• To help follow a particular path through a dense and overlapping chart, you can now assign priority to specific links so that they are shown clearly, in front of other links. This option can be especially useful when using angled links. Explore the use of link priority, used to highlight the attack path, in the Cloud Security demo.

Enhancements

• The technology behind the ReGraph Playground has been updated and improved, loading more quickly to provide a better development experience.
• We've significantly improved performance of charts using the onItemInteraction event in various situations such as foregrounding combos or styling items selected by marquee selection.

Known Limitations

• Using flow on angled links is currently not supported. We are working to add this feature in a future release. For more details, please contact us.

Bugs Fixed

• An overview window set to a custom size now always looks and works as expected.
• Fixed an issue where adding a set of glyphs on nodes could sometimes make the chart unresponsive.

Let your charts speak with annotations!

When visualizing connected data, a beautiful chart is just the beginning — the next step is to tell the story behind the data.

ReGraph annotations bring a new dimension to graph visualization, fitting seamlessly into your application and elevating your workflow.

Annotations add a narrative layer to your charts so that you can analyze, capture, discuss and share insights directly within the chart. You can annotate nodes, links and combos, and annotations will stay readable at any chart size and zoom level.

Start exploring annotations in our brand new Investigative Workflows showcase.

Annotations for any use case

Turn AI-generated or algorithm-based alerts into annotations and highlight the most important parts of your network. Using ReGraph events, you can add interactive elements on annotations to allow your end user to deal with these alerts, creating an end-to-end in-chart process for visualizing and resolving network alerts.

See an example of this in our updated Cloud Security showcase.

You can also use annotations to show real-time insights in a collaborative workflow between colleagues or investigators. The data-driven loading of annotations lets you save and then reload user-generated or user-editable insights. Once complete, export annotated charts into a shareable jpeg, svg, png or pdf format using the export function.

The Investigative Workflows showcase is an example of this create, edit and export workflow.

All levels of styling and customization

You have full control over the styling of annotations to create the look that suits your application design and interface.

The annotation body, styled in the annotation object, can show any content including text, images, font icons, or even simple buttons created using labels. You can also add your own controls such as editable text fields using an HTML overlay and the new labelPosition instance method.

The connector, styled in the connectorStyle object, lets you customize how annotations link to their subjects so that the connection is immediately clear to the chart users.

Explore the full range of possibilities in a new suite of annotation examples:

• Annotation Basics - understand annotations and their parts, behavior and subjects
• Advanced Annotation Gallery - explore various annotation styles
• User-Created Annotations - discover user-created annotations with text input fields

We've also added a new Investigative Workflows showcase where you can try out creating, editing and exporting annotations in a chart.

To get started with annotations, take a look at the new Annotations documentation.

Enhancements

• We've now also added an annotation to the Events example.
• ReGraph fully supports Leaflet v1.9.x, and our SDK site now uses Leaflet v1.9.4.
• We've updated our Welcome page with a fresh new design.
• To continue improving security, consistency and quality of our codebase, we've added a new suite of scanners. Read more in the Security documentation.

Features out of Beta

After a period of improving, testing and implementing your feedback, the following are now officially out of beta:

• The onItemInteraction event
• The chart export instance method
• The onUpdateComplete event

Bugs Fixed

• Loading a chart with an item set to undefined no longer produces an error.
• The positions prop is now respected when positioning all items in the chart.
• gridShape is now applied correctly when the combo data is loaded on first render.
• Setting the overview option to true without specifying its backgroundColor now correctly defaults to the chart backgroundColor.

Breaking Changes

• In previous versions, labels were drawn over glyphs by default. From 5.0, glyphs are now drawn over labels by default because this ordering is generally better when using both. To keep the order as before, with labels drawn over glyphs, set legacyGlyphAndLabelOrdering to true.
• ReGraph now sets the overview backgroundColor to undefined by default which means that it's inherited from the chart backgroundColor. Previously the default overview background color was 'white'. To achieve the same look, set the overview backgroundColor to 'white'.

TypeScript Changes

• The Item interface no longer contains fade and times properties. Instead, a new GraphItem interface extends Item and contains fade and times properties. The Node and LinkStyle interfaces now extend GraphItem.

Deprecations

• We've deprecated the image instance method. Use export instead.
• We've deprecated the gridShape option in the combo setStyle function. Set gridShape in the arrange property of the combo setStyle instead.

Advanced Notice: Retirement of LTA

We've deprecated ReGraph 3.10.1 (LTA), which means that from March 1, 2026, this version will no longer be available and support for this version will end.