For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Resources
Get started
ReferenceGuidesExamplesChangelog
ReferenceGuidesExamplesChangelog
  • Designer API
    • Introduction
    • Getting Started
    • Webflow CLI
    • Error Handling
    • App Modes
  • Elements
    • Creating & Retrieving Elements
    • Element Properties & Methods
    • Element Types & Methods
  • Styles
    • Managing Style Properties
    • Managing Variable Modes
  • Components
      • Get all components
      • Get component by name
      • Get component by ID
      • Search for components
      • Get the selected component
      • Get all variants of a component
      • Get selected variant
      • Get a variant by ID
      • Create a variant
      • Set variant settings
      • Reorder variants
      • Delete a variant
      • Get component instance count
      • Create a component
      • Delete a component
  • Variables & Collections
    • Variable Collections
    • Variables
    • Variable Modes
  • Assets
  • Pages & Folders
  • Utilities
    • User Events & Notifications
    • App Intents & Connections
  • Additional Resources
    • API Playground
    • FAQs
LogoLogo
Resources
Get started
On this page
  • component.reorderVariants(variantIds)
  • Syntax
  • Parameters
  • Returns
  • Examples
  • Designer Ability
ComponentsCreating & Retrieving Components

Reorder variants (Beta)

Was this page helpful?
Previous

Delete a variant (Beta)

Next
Built with

component.reorderVariants(variantIds)

Reorders the variants of a component by specifying the desired order as an array of variant IDs.

Beta

These methods are in public beta and may change with future releases.

Syntax

1component.reorderVariants(variantIds: string[]): Promise<void>

Parameters

  • variantIds: string[] — An array of variant IDs in the desired order. Pass 'base' to refer to the base variant. For a partial reorder, include only the variants to reposition. Remaining variants shift to follow the last repositioned variant.

Returns

Promise<void>

A Promise that resolves when the reorder is complete.

Examples

Fully reorder all variants:

1const component = await webflow.getCurrentComponent()
2
3if (component) {
4 await component.reorderVariants(['base', 'variant-2', 'variant-1', 'variant-3'])
5}

Partially reorder variants:

1const component = await webflow.getCurrentComponent()
2
3if (component) {
4 // Before: base, variant-1, variant-2, variant-3
5 await component.reorderVariants(['variant-1', 'variant-3'])
6 // After: base, variant-1, variant-3, variant-2
7}

Try this example

Designer Ability

Designer AbilityPermissionLocaleBranchWorkflowSitemode
canModifyComponentsanyanyanyCanvasDesign