# \[공지\] SDK 3.x 업데이트에 따른 localStorage 접근 이슈 안내 **URL:** \ **Category:** 개발 공지사항\ **Created:** [8월 20, 2026, 6:32오전 UTC](https://techchat-apps-in-toss.toss.im/t/sdk-3-x-localstorage/4649 "2026-08-20T06:32:24Z")\ **Posts on this page:** 1\ **Showing post:** 1
**Author:** ![Dylan](https://yyz1.discourse-cdn.com/flex007/user_avatar/techchat-apps-in-toss.toss.im/dylan/32/597_2.png) [@Dylan](https://techchat-apps-in-toss.toss.im/u/Dylan)\ **Post date:** [8월 20, 2026, 6:32오전 UTC](https://techchat-apps-in-toss.toss.im/t/sdk-3-x-localstorage/4649/1 "2026-08-20T06:32:24Z")
안녕하세요, 앱인토스 팀입니다. SDK 3.x 마이그레이션 시 브라우저 `localStorage`를 사용하고 있는 서비스에 영향을 줄 수 있는 변경 사항이 있어 안내드립니다. SDK 3.x에서는 서비스 구조 변경에 따라 서빙되는 Origin이 변경되었습니다. SDK에서 제공하는 `Storage`를 사용하고 있는 경우에는 별도 영향이 없습니다. 다만, SDK에서 제공하는 `Storage`가 아닌 브라우저의 `localStorage`를 직접 사용해 데이터를 저장한 경우, Origin 변경에 따라 SDK 3.x 환경에서는 기존 데이터에 접근할 수 없습니다. 브라우저 `localStorage`는 Origin을 기준으로 데이터가 분리되기 때문에, SDK 3.x로 마이그레이션한 이후에는 기존 Origin에 저장된 데이터가 자동으로 이전되지 않습니다. 기존 SDK 2.x 환경에서 브라우저 `localStorage`를 직접 사용해 온 서비스의 원활한 전환을 위해, 기존 데이터를 SDK 3.x에서도 이어서 활용할 수 있는 마이그레이션 지원 방안을 검토하고 있습니다. 따라서 브라우저 `localStorage`를 직접 사용하고 있으며 기존 데이터 유지가 필요한 경우에 한해, 관련 지원이 제공되기 전까지 SDK 3.x로의 마이그레이션을 잠시 보류해 주시길 권장드립니다. SDK에서 제공하는 `Storage`를 사용하고 있거나 기존 `localStorage` 데이터 유지가 필요하지 않은 경우에는 이번 변경의 영향을 받지 않으며, SDK 3.x로 마이그레이션하셔도 됩니다. 또한 `localStorage`는 영구적인 데이터 보관을 보장하는 저장소가 아니므로, 서비스에서 유지가 필요한 데이터는 가급적 `@apps-in-toss/web-framework` 에서 제공하는 `Storage` API를 사용해 관리하는 것을 권장드립니다. 특히 사용자의 기기 변경 이후에도 유지되어야 하는 데이터의 경우 클라이언트 저장소에 의존하기보다는, 별도의 서버 통신을 통해 데이터를 저장하고 불러올 수 있는 구조로 구현하는 것을 권장드립니다. 구체적인 마이그레이션 지원 방법과 일정은 확정되는 대로 다시 안내드리겠습니다. 감사합니다. --- _[View the full topic](https://techchat-apps-in-toss.toss.im/t/sdk-3-x-localstorage/4649)._