On this page

Instance swap

You used instance swap in a layer in a component instance.

Select Reset overrides to revert the instance swap and change the main component so that swapping is not needed.

How to construct components without instance swap

The following example shows an icon button component built without using instance swap. An instance of an icon component that has different icons as variants is nested within the IconButton component.

The properties of the nested icon instance are exposed in the component properties panel.

Constructing components without instance swap

When the properties of the nested icon instance are exposed in the component properties panel, selecting a different icon from the variants of the icon component becomes easy.

A button without instance swap

An instance of the IconButton.

See also Fix conversion issues, Components, and Variants.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.