Changelog

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.

• 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 three-dot 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.

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.

• 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.

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 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.

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.

• 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

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

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.

Keep the feedback coming.

The Color control now accepts an object with color and opacity fields for its defaultValue, making it easy to set semi-transparent defaults directly in your component registration.

• Object form defaultValue — Pass { color: "#000000", opacity: 0.5 } instead of a plain color string to define a default with transparency
• Resolved RGBA string — The control still passes a single RGBA string to your component, so no changes are needed in your component code
• Backward compatible — Plain CSS color strings (e.g., "black", "#4f46e5") continue to work as before

New guides walk you through serving multiple Makeswift sites from a single Next.js application using tenant-specific Site API keys.

• Subdomain-based routing — Route tenants with subdomains like siteA.example.com
• Path-based routing — Route tenants with URL path prefixes like example.com/siteA, with subdomain support for the Visual Builder

The Code control adds a full-featured code editor to the Makeswift builder, giving content teams a professional editing experience for source code snippets.

• Monaco-powered editor — Opens an editor in a dialog using the same engine that powers VS Code, with syntax highlighting, line numbers, and familiar keyboard shortcuts
• Automatic language detection — The editor detects the language from content automatically, covering JavaScript, TypeScript, HTML, CSS, JSON, YAML, Python, Go, Rust, SQL, shell, and many others
• Standard control interface — Follows the same pattern as other controls with label, description, and defaultValue options

We’re excited to announce the launch of our brand-new documentation site, now powered by Fern! The new docs feature a refreshed design, improved navigation, and a better experience for finding the information you need.