For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
LogoLogo
Sign in
    • Changelog
  • Changelog
  • August 14, 2026
  • August 12, 2026
  • August 11, 2026
  • August 3, 2026
  • July 23, 2026
  • July 16, 2026
  • June 23, 2026
  • June 17, 2026
  • June 10, 2026
  • June 8, 2026
  • June 1, 2026
  • May 22, 2026
  • May 21, 2026
  • May 20, 2026
  • April 13, 2026
Sign in
On this page
  • August 14, 2026
  • Navigation Sidebar updates
  • August 12, 2026
  • Sort elements using keyboard arrows
  • August 11, 2026
  • Resource References in the Visual Builder
  • August 3, 2026
  • Diagnostics dialog in the Visual Builder
  • July 23, 2026
  • Availability badges in the sidebar
  • July 16, 2026
  • Apps are now generally available
  • June 23, 2026
  • New IconRadioGroup control
  • June 17, 2026
  • Connect our docs to your AI agent
  • June 10, 2026
  • Quickly jump between Makeswift, BigCommerce, and Feedonomics docs
  • June 8, 2026
  • New Slider control

Changelog


August 14, 2026
August 14, 2026

August 12, 2026
August 12, 2026

August 11, 2026
August 11, 2026

August 3, 2026
August 3, 2026

July 23, 2026
July 23, 2026

July 16, 2026
July 16, 2026

June 23, 2026
June 23, 2026

June 17, 2026
June 17, 2026

June 10, 2026
June 10, 2026

June 8, 2026
June 8, 2026
Older posts
Next
Built with

Navigation Sidebar updates

The Navigation Sidebar has been reorganized around a split pane that shows your pages and the Elements Panel at the same time, and you can now sort elements directly in the Elements Panel.

The Navigation Sidebar showing Content and Design tabs, a list of pages in the top pane, and the Elements Panel in the bottom pane
The updated Navigation Sidebar with Pages and Elements in a split pane
  • Split pane for pages and elements — pages and the Elements Panel share the sidebar, so you can move between pages and inspect the structure of the current page without switching panels.
  • Settings in the site switcher — workspace and site settings have moved into the site switcher menu at the top of the sidebar.
  • Files manager button — files open from the button beside the Content and Design tabs.
  • Updated Help button — the ? button in the bottom left now opens Contact support, View docs, Shortcuts, and the updated Diagnostics dialog for gathering diagnostic information.
  • Sort elements in the Elements Panel — drag an element in the Elements Panel to reorder it within its parent, without dragging it on the Canvas.
Reordering elements by dragging them in the Elements Panel

For details, see The basics.

Sort elements using keyboard arrows

Select an element in the Canvas or Elements Panel in the left sidebar and press an arrow key to move it within its parent, without dragging it.

  • Left and right — reorder an element with its direct siblings in the same Box or Slot row.
  • Up and down — move an element between rows, when it sits in a row by itself and the adjacent row above or below also holds a single element.
  • Scoped to the parent — arrow keys move an element within its Box or Slot only.

Resource References in the Visual Builder

Some resource changes affect more than one page. Resource References show all of the places a resource is used, so you can add, edit, and delete resources with confidence.

A color's edit panel showing a Used in n places item, expanded to a list of pages and regions, with a page expanded to show its locales
Resource References for a site color
  • Supported resources: colors, text styles, files, and global components.
  • Usage count in context: a Used in n place(s) item appears in the resource’s Action Menu (⋯), or in a color or text style’s edit panel.
  • Pages and regions: the submenu lists the pages using the resource, plus the regions using it. Click a page to navigate to it; regions are listed for reference only, since they can be shared across multiple pages.
  • Locale aware: expand a page to see which locales use the resource, and navigate straight to that page in a specific locale.

References are tracked through pages and regions, not through global components or text styles. A color that is used inside a global component that is used on 3 pages will report as being used on 3 pages. If that global component is not used on any pages or regions, the color will show no resource references.

For details, see Resource References.

Diagnostics dialog in the Visual Builder

The Copy diagnostics item in the Visual Builder Help menu has been replaced with Diagnostics, which opens a dialog where you can review diagnostic information before sharing it.

The Diagnostics dialog showing builder identifiers, host information, and host connection details
The Diagnostics dialog in the Makeswift Visual Builder
  • Review before you share: diagnostics are grouped into sections for builder identifiers, host information, host connection, selection, and browser information.
  • Copy or download: copy a readable report, copy the full diagnostics data, or download it as a ZIP file to attach to a support request.
  • Section-level copying: copy an individual section instead of the whole report.

For details, see Diagnostics.

Availability badges in the sidebar

The documentation site now shows availability badges in the sidebar navigation, making it easier to spot the status of a page before you open it. This is a documentation-site improvement, not a change to Makeswift itself.

  • Beta and deprecated indicators: pages marked beta or deprecated now surface that status directly in the sidebar.
  • Faster scanning: identify pre-release and legacy content at a glance while browsing the navigation.

Apps are now generally available

Apps are out of Early Access and available to everyone. You no longer need to enable an early access setting before creating an app to authenticate with the Makeswift REST API.

  • No setup required — head straight to Settings → Workspace → Apps to create an app and get your API key.

For details, see Authentication.

New IconRadioGroup control

The IconRadioGroup control adds an icon-based radio group panel to the Makeswift builder, letting developers offer visual icon options for component properties like alignment, layout direction, or style variants.

An IconRadioGroup panel in the Makeswift builder with rows of selectable alignment and icon options
An IconRadioGroup panel showing Alignment and Icons options
  • Kebab-case icon values — Pass icons as bare strings (e.g., "text-align-left", "arrow-right") or use the IconRadioGroup.Icon accessor
  • 169 built-in icons — Full set of icons covering alignment, arrows, layout, logos, and more
  • Typed generic prop — The control passes the selected option’s value as a typed string to your component

Example

1import { IconRadioGroup } from "@makeswift/runtime/controls";
2
3runtime.registerComponent(TextBlock, {
4 type: "text-block",
5 label: "Text Block",
6 props: {
7 alignment: IconRadioGroup({
8 label: "Alignment",
9 options: [
10 { value: "left", label: "Left", icon: "text-align-left" },
11 { value: "center", label: "Center", icon: "text-align-center" },
12 { value: "right", label: "Right", icon: "text-align-right" },
13 ],
14 defaultValue: "left",
15 }),
16 },
17});

For full documentation, see the IconRadioGroup control reference.

Connect our docs to your AI agent

We’ve added a dedicated AI Agent Setup page that walks you through connecting the Makeswift docs to your AI tool — so it can answer questions grounded in our documentation instead of guessing.

  • One-click install for Cursor and Claude Code via the Copy page dropdown in the upper-right of any docs page
  • Manual setup snippets for Cursor, Claude Code, Codex, and Claude Desktop
  • Bottom-pinned sidebar link on every tab so the page is reachable from anywhere on the site

Powered by the docs site’s MCP server at https://docs.makeswift.com/_mcp/server.

Quickly jump between Makeswift, BigCommerce, and Feedonomics docs

Thanks to your feedback, the header logo is now a site switcher. Click the logo at the top-left of any page to open a dropdown and jump straight to the BigCommerce or Feedonomics docs without leaving your tab.

Makeswift logo opened to reveal a dropdown with links to the BigCommerce and Feedonomics docs sites
The new site switcher in the Makeswift Docs header

Keep the feedback coming.

New Slider control

The Slider control adds a draggable slider to the Makeswift builder, letting content teams set a number prop within a range you define instead of typing a raw value.

A Slider panel in the Makeswift builder with a draggable track and a numeric input
A Slider panel on a component to set a numeric value
  • Bounded range — min, max, and step constrain the values a content editor can set.
  • Optional numeric input — Set showInput to true to display an input field alongside the slider for precise values.
  • Plain number prop — Your component receives a number, or undefined when no value is set and no defaultValue is provided.

Example

1import { Slider } from "@makeswift/runtime/controls";
2
3runtime.registerComponent(Banner, {
4 type: "banner",
5 label: "Banner",
6 props: {
7 opacity: Slider({
8 label: "Opacity",
9 defaultValue: 100,
10 min: 0,
11 max: 100,
12 step: 1,
13 }),
14 },
15});

For full documentation, see the Slider control reference.