Troubleshooting

Best Practices

General troubleshooting tips

Before contacting KeyLines Support about an issue, you may want to consider the following:-

  • What version of KeyLines are you using? Is it the latest?
  • Has your license expired?
  • Are you running in WebGL or Canvas mode?

You can find the answers to these questions using the KeyLines.info() function, and it's worth having this information to hand if you do contact Support.

My chart has gone blank - what might be causing this?

Your evaluation version of KeyLines may have expired. If your evaluation period is extended you should download the latest version from the download page and clear your caches. It's a good idea to check in the development tools that the right version of KeyLines is appearing in the browser - you can check the version number in the comment at the head of the file.

Why am I seeing a license expired watermark?

Your PoC or subscription license may have expired. There is a grace period where the license expired watermark will be displayed to enable you to renew or purchase a license for KeyLines to avoid interruption to your service.

Why do my SVG icons fail to load in some browsers?

If some browsers fail to load your SVG icons while others work correctly, it's likely a browser issue. One of the causes might be the size of the SVG file. To improve cross-browser compatibility, set the width and height attributes in your SVG files or optimise the size of your SVG using an optimiser such as SVGO.

How do I stop nodes moving around when I add data?

You can do this is using the chart.expand() function with the fix option set to 'adaptive' (default option), which adds new items to the chart and then lays them out while keeping existing nodes fixed.

For the organic layout, an alternative approach is to use chart.merge() and then in the promise apply chart.layout() with the mode option set to 'adaptive' - this will adjust the position of existing nodes slightly to make space for the new nodes.

Browser issues

As a general troubleshooting step, if KeyLines won't load, make sure that JavaScript is enabled in your browser settings.

Firefox on Windows

If you turn on hardware acceleration, font rendering in HTML5 Canvas may look blurred. To fix this, turn it off:

  1. Click on the Firefox Application Menu icon and click on Settings.
  2. Navigate to the General tab and scroll to the Performance section.
  3. Uncheck Use recommended performance settings. Additional settings will appear.
  4. Uncheck Use hardware acceleration when available.
Screenshot of the General tab in Firefox settings

Firefox and context menus

You can configure Firefox to prevent JavaScript overriding standard context menus.

To do this, you need to ask your users to disable the right-click in the Configuration page.

  1. In address bar, type about:config and press Enter. When prompted, confirm that you wish to continue to change advanced configuration preferences.
  2. Navigate to the Search bar and start typing dom.event.contextmenu.enabled.
  3. Once the contextmenu event appears in the list, toggle it to to "false".
Screenshot of Advanced configuration preferences in Firefox

Terms of use

These terms do not alter or supersede any existing agreements between you (or your employer) and us.

By accessing or using any Content you agree to be bound by these Terms of Use. Please review these terms carefully before using the website.

The contents of this website, including but not limited to any text, code samples, API references, schemas, interactive tools, and other materials (collectively, the 'Content'), are made available for informational and internal evaluation purposes only. All intellectual property rights in the Content are reserved. No licence is granted to use the Content for any commercial purpose, or to copy, distribute, modify, reverse-engineer, or incorporate any part of the Content into any product or service, without our prior written consent.

This Content is provided “as is” and “as available,” without any representations, warranties, or guarantees of any kind, whether express or implied, including but not limited to implied warranties of merchantability, fitness for a particular purpose, non-infringement, or accuracy. To the fullest extent permitted by applicable law, we expressly exclude and disclaim all implied warranties, conditions, and other terms that might otherwise be implied.

We disclaim all liability for any loss or damage, whether direct, indirect, incidental, consequential, or otherwise, arising from any reliance placed on the Content or from your use of it, to the fullest extent permitted by applicable law. By continuing to access or use the Content, you acknowledge and agree to these terms.