The installation property controls how your component appears when a Wix user first adds it to a page, including its initial dimensions, which preset it starts with, and where it's placed. It works together with layout: installation sets the starting size, and layout controls how the Wix user can resize from there.
installation is defined on the same level as type and editorElement, not inside editorElement. See the manifest structure.
The installation object supports the following fields:
Dimensions when first added to the page.
Preset keys for different screen sizes.
Where to place the component on the page.
The initialSize field controls the starting dimensions when a Wix user first adds your component to a page. Each dimension (width and height) is configured independently with a sizing type.
The component has a set width but grows vertically to fit its content. This is the most common pattern, used by text components, accordions, and tabs.
The component stretches to fill its parent section while the height adjusts to content. Useful for banners, marquees, and full-width layouts.
Both dimensions adjust to the component's content. This works for components with an intrinsic size, like icon bars or badges.
The component maintains its width-to-height ratio when the user resizes it. Use preserveAspectRatio only when both dimensions use 'pixels' sizing. Primarily useful for media components like images, videos, and logos.