FAQ

Frequently-asked questions

Can diagrams be embedded in other documents and pages?

Yes! See Share links & embeds for details.

How do I share feature suggestions?

Submit your ideas through our Feedback portal, where you can also vote on other users’ suggestions. We actively review these posts to gauge interest and prioritize future development. You also get notified when a feature that you upvoted gets released!

I have an issue, how do I get help?

Start by reviewing the Troubleshooting page. If your issue isn’t covered, you can:

  • Contact your Customer Success Manager (Scale customers).

  • Use the Contact Us feature in the Help Center.

  • Email [email protected] (if Contact us feature isn’t accessible)

For technical issues, including a recording is preferred, as it provides the most complete context. Screenshots and detailed reproduction steps are also helpful.

Getting help

When using Contact Us, be sure to select the appropriate I need help with option to ensure you receive the support you need:

  • Support - An immediate issue you need resolved ASAP

  • Bug - An unexpected behavior that can be addressed in a future release

  • Sales - Questions regarding billing or licenses

  • Other - Miscellaneous inquiries

Where are the objects and connections from my other diagram?

Changes to model objects and connections propagate across the model, but diagrams display only what has been explicitly added.

Our reasoning for this design choice is that each diagram is meant to tell a specific story, so automatically adding objects from other diagrams often disrupts the intended narrative.

Instead, a number of tools are provided to support quickly adding existing content to any diagram, including:

Why am I getting an “already exists” error?

Each model object must have a unique name within its scope. Violating this rule raises an “already exists” error.

In practice, this means that a model object cannot share a name with another object that:

  • Share the same parent, or

  • Reside higher in the hierarchy within the same Domain.

Otherwise, sharing names is allowed.

This lets you apply the same naming conventions across Systems, as long as no ambiguities arise. For example, each system can have a Store named “database” and an App named “front-end” without issue.

Why isn’t the Technology I want available?

There are a lot of technologies out there, so we probably just haven’t added it yet!

You can add a new Technology choices by following Adding a new technology. Once added, it is immediately available to all users in your organization.

Can I change multiple objects at once?

Yes, IcePanel supports multi-selection! Options include:

  • Multi-select / unselect: Shift + Click (each object)

  • Multi-select box: Shift + Click + drag

Changes made while a selection is active apply to all objects it contains. Common use cases include:

See the Hotkeys article for more useful shortcuts!

Should Interfaces be modeled as objects or connections?

Many interfaces meet the criteria for Systems and are therefore best modeled as objects.

#

Criteria

Interface

1

Delivers value to its users, whether they are human or not.

✔ Transforms and transports data between Systems.

2

Owned and maintained by a single technical team.

✔ Typically managed by a middleware or data team

For diagrams aimed at non-technical audiences, using the via property of Connections to reference interfaces instead of explicitly showing them can help reduce visual noise.


Any other questions? Reach out to us [email protected] 🧊

Last updated

Was this helpful?