{"@context":"https://schema.org","@graph":[{"@type":"TechArticle","headline":"Upgrade Guide","description":"Review version changes and migration steps for Intent UI.","url":"https://intentui.com/docs/prologue/upgrade-guide","author":{"@type":"Person","name":"Irsyad","url":"https://x.com/irsyad"},"publisher":{"@type":"Organization","name":"Intent UI","url":"https://intentui.com","logo":{"@type":"ImageObject","url":"https://intentui.com/icon.svg"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://intentui.com/docs/prologue/upgrade-guide"}},{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://intentui.com"},{"@type":"ListItem","position":2,"name":"Docs","item":"https://intentui.com/docs"},{"@type":"ListItem","position":3,"name":"Prologue","item":"https://intentui.com/docs/prologue"},{"@type":"ListItem","position":4,"name":"Upgrade Guide","item":"https://intentui.com/docs/prologue/upgrade-guide"}]}]}
Upgrade Guide
2026 Upgrade Guide
No migration steps are listed for 2026. See the release notes for changes.
2025 Upgrade Guide
See Release v3 for the 2025 changes.
Upgrade steps
- Change any of
square-petite,extra-small,small,medium,largetoxs,sm,md,lg, andsq-[xs, sm, md, lg]in thesizeprop. - Remove the
shapeprop fromButton,Badge,Tag, andToggle. Use theisCircleprop instead. - Remove
focusRingandfocusStylesfromprimitive.ts—they are no longer used.