# Wix 헤드리스: 사이트를 사용자 지정 프런트엔드로 전환하기

Source: https://support.wix.com/ko/article/wix-headless-moving-your-site-to-a-custom-frontend-ko (updated 2026-11-03)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

> 이 기능은 현재 계정 언어가 영어인 경우에만 이용할 수 있습니다.

Wix 에디터에서 제작한 프런트엔드를 Claude Code, Cursor, Codex와 같은 AI 코딩 도구로 제작한 사용자 지정 프런트엔드로 교체해 비즈니스용 새 사이트를 만들 수 있습니다.

연결된 비즈니스 도구(예: Wix 쇼핑몰, Wix 예약)와 데이터(예: SEO, 사이트 통계)는 중단 없이 계속 작동합니다. 기존 사용자 지정 프런트엔드가 있다면 AI 코딩 도구를 사용해 Wix 헤드리스 프런트엔드로 전환할 수 있습니다.

[Video](https://www.youtube.com/embed/ydHT8tO0j70)

---

## 어떤 경우에 적합한가요?

사용자 지정 도메인이 연결된 라이브 Wix 사이트가 있으며 방문자에게 표시되는 프런트엔드만 AI 코딩 도구로 제작한 프런트엔드로 교체하려는 경우, 헤드리스 사이트로 이전할 수 있습니다.

다음과 같은 경우 Wix 헤드리스로 이전하는 것이 적합할 수 있습니다.

* 비즈니스 도구(예: Wix 쇼핑몰, Wix 예약, 연락처, 회원)가 연결된 라이브 Wix 사이트가 있으며, 기존 기능을 다시 구축하지 않고 프런트엔드만 새로 만들려는 경우
* 직접 프런트엔드를 코딩해 디자인을 자유롭게 구현하려는 경우(사이트를 작업하는 개발자 또는 에이전시 포함). 즉, Wix 에디터에서 사이트를 제작하지 않으려는 경우
* 사이트 통계와 SEO를 포함한 기존 사이트 데이터를 유지하면서 프런트엔드만 새로 만들려는 경우
* 라이브 사이트에 영향을 주지 않고 AI 코딩 도구로 사이트 제작을 시도하려는 경우

> **참고:** Wix 에디터 또는 Studio 에디터에서 시각적으로 사이트를 제작하는 방식을 선호하거나 개발자 또는 AI 코딩 워크플로가 없다면 Wix 헤드리스로 이전하지 않는 것이 좋습니다. Wix 헤드리스를 사용하려면 자체 프런트엔드 코드가 필요합니다.

### 시작하기 전에 알아두어야 할 사항

* **사이트에 사용자 지정 도메인이 필요합니다.** Wix 헤드리스 이전은 사용자 지정 도메인이 연결된 사이트에서만 이용할 수 있습니다.
* **한 번에 하나의 프런트엔드만 라이브로 운영할 수 있습니다.** 새 프런트엔드로 전환하면 방문자에게 표시되는 현재 프런트엔드가 교체되며, 두 프런트엔드를 동시에 라이브로 운영할 수 없습니다.
* **SEO 데이터도 새 프런트엔드로 이전됩니다.** 이전을 완료하면 SEO와 사이트 통계가 새 프런트엔드에 자동으로 연결됩니다. 단, 페이지, 콘텐츠 또는 사이트 구조를 크게 변경하면 SEO에 영향을 줄 수 있습니다.
* **지원되는 앱을 확인합니다.** 전환 후에도 연결된 앱 대부분은 계속 작동하지만, 일부 앱은 현재 새 프런트엔드에서 지원되지 않습니다. 지원되지 않는 앱도 사이트 대시보드에서 계속 관리할 수 있습니다. [지원되거나 지원되지 않는 앱의 전체 목록을 확인하세요.](https://support.wix.com/ko/article/wix-headless-supported-and-unsupported-apps)

### 사이트 이전 요구 사항

이전을 시작하려면 사이트가 다음 요구 사항을 모두 충족해야 합니다.

* **사이트 소유자여야 합니다.** 이전은 사이트 소유자만 시작할 수 있습니다. 공동 작업자인 경우 사이트 소유자에게 이전을 시작해 달라고 요청하세요.
* **사이트에 사용자 지정 도메인이 연결되어 있어야 합니다.** 시작하기 전에 사이트에 [도메인을 연결](https://support.wix.com/ko/article/about-domains)합니다.
* **쇼핑몰에서 새로운 Wix 쇼핑몰 카탈로그를 사용해야 합니다.** 사이트에서 Wix 쇼핑몰을 사용하는 경우 [새 제품 카탈로그](https://support.wix.com/ko/article/introducing-the-new-wix-stores-product-catalog)를 사용해야 합니다.
* **사이트에서 앱 프로젝트의 사용자 지정 구성 요소를 사용하지 않아야 합니다.** 현재 사이트에 앱 프로젝트의 일부로 제작된 사용자 지정 구성 요소가 포함되어 있다면 아직 이전할 수 없습니다. 헤드리스로 전환하려면 대신 [새 헤드리스 사이트를 추가](https://support.wix.com/ko/article/wix-headless-creating-a-site-with-ai-tools)합니다.

---

## 이전 절차는 어떻게 진행되나요?

마이그레이션이 어떻게 진행되는지 단계별로 알아봅니다. 마이그레이션을 시작하려면 다음 섹션의 단계를 따르세요.

1. **마이그레이션을 시작합니다.** 사이트 대시보드의 헤드리스 설정에서 마이그레이션을 시작합니다. Wix 헤드리스에서 해당 사이트의 상세 정보가 포함된 프롬프트를 제공합니다.
2. **AI 코딩 도구로 새 프론트엔드를 구축합니다.** 프롬프트를 AI 코딩 도구에 붙여넣은 후 방문자에게 표시될 페이지, 섹션, 요소를 모두 구축합니다. 새로 시작하거나 현재 디자인을 복사해 기본으로 사용할 수 있습니다. 마이그레이션을 진행하면서 프론트엔드를 구축하거나, 마이그레이션을 시작하기 전에 미리 구축할 수 있습니다.
3. **새 프론트엔드를 미리보고 테스트합니다.** 새 프론트엔드는 현재 사이트와 나란히 별도의 보기로 표시됩니다. 방문자에게는 라이브 사이트만 표시되므로, 원하는 디자인과 기능을 구현할 때까지 계속 수정할 수 있습니다. 제품, 서비스, 예약 및 기타 데이터는 그대로 유지되며 새 프론트엔드에 연결할 수 있습니다.
4. **새 프론트엔드로 전환합니다.** 준비가 완료되면 새 프론트엔드를 라이브 사이트로 설정합니다. 사용자 지정 도메인과 데이터 추적 기능이 이전되며 기존 사이트는 게시 취소됩니다. AI 코딩 도구로 추가한 페이지만 새 사이트에 표시됩니다. 언제든지 기존 사이트로 다시 전환할 수 있습니다.

---

## 사이트를 사용자 지정 프론트엔드로 이전하기

Wix 헤드리스로 이전하고 AI 코딩 도구로 새 프론트엔드를 구축한 후, 준비가 완료되면 게시하세요.

> **시작 전 확인 사항:** 사이트가 위의 모든 [요구 사항](https://support.wix.com/ko/article/wix-headless-moving-your-site-to-a-custom-frontend#requirements-for-migrating-your-site)을 충족하는지 확인합니다.

### 사이트를 사용자 지정 프론트엔드로 이전하려면:

1. 사이트 대시보드에서 [헤드리스 설정으로 이동](https://manage.wix.com/my-account/site-selector/?siteType=HtmlWeb&actionUrl=https://www.wix.com/dashboard/{{metaSiteId}}/oauth-apps-settings?referralInfo=settings-lobby?&title=Select%20a%20site&buttonText=Go+to+Headless+Settings)합니다.
2. 아래로 스크롤한 후 **헤드리스 마이그레이션**에서 **마이그레이션 시작**을 클릭합니다.
3. **지금 시작**을 클릭해 새 프론트엔드에 비즈니스를 설정합니다.
4. 마이그레이션되는 앱과 지원되지 않는 앱을 확인한 후 **계속**을 클릭합니다.
5. **프롬프트 복사**를 클릭한 후 AI 코딩 에이전트에 붙여넣습니다. 헤드리스 스킬을 통해 해당 사이트에 대한 정보가 에이전트에 전달됩니다.

![헤드리스 마이그레이션 과정에서 프롬프트를 복사하는 단계입니다.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/0e97b94c-47b2-498e-a44b-b1be88db7e56/2026/10/07/0de5e88d-3cf9-4200-9aa4-9612fdc88b1d/Headless_migration.jpg)

1. AI 코딩 에이전트로 프론트엔드를 구축하고 계속 개선합니다.
2. (선택사항) 헤드리스 사이트를 미리보려면 헤드리스 설정에서 **보기**를 클릭합니다.
3. **마이그레이션 완료**를 클릭합니다.
4. 프롬프트를 복사해 AI 코딩 에이전트에 붙여넣은 후 새 프론트엔드로 교체하고 게시합니다.

> **다음 단계:** 전환 후 양식, 리디렉트, SEO, 사이트 통계 등 다시 구축해야 하는 항목을 확인합니다. [마이그레이션 후 체크리스트](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/get-started/post-migration-checklist-wix-studio-and-editor-sites-to-headless)를 확인하고 AI 코딩 도구와 공유하세요.

---

## 자주 묻는 질문

아래 질문을 클릭해 Wix 헤드리스로 마이그레이션하는 방법에 대한 자세한 내용을 확인하세요.

**전환하기 전에 새 프론트엔드를 미리볼 수 있나요?**

네. 전환하기 전에 새 프론트엔드를 원하는 만큼 미리볼 수 있습니다. 전환하기 전까지 현재 사이트는 계속 운영되며 아무것도 변경되지 않습니다.

**마이그레이션을 시작하기 전에 프론트엔드를 구축할 수 있나요?**

원하는 방식으로 진행할 수 있습니다. 먼저 AI 코딩 도구로 사용자 지정 프론트엔드를 구축한 후 준비가 되면 마이그레이션하거나, 마이그레이션을 시작하면서 프론트엔드를 구축할 수 있습니다.

**새 프론트엔드로 전환하면 되돌릴 수 없나요?**

아니요. 사이트 대시보드의 헤드리스 설정 페이지에서 **기존 사이트로 전환**을 클릭하면 언제든지 이전 사이트로 돌아갈 수 있습니다.

**전환하면 이전 사이트는 어떻게 되나요?**

> 새 프론트엔드를 게시하면 해당 프론트엔드가 기본 사이트로 설정됩니다. 이에 따라 다음 변경사항이 적용됩니다.
> 
> * 사용자 지정 도메인이 새 사이트로 전환되고 이전 사이트의 게시가 취소됩니다.
> * SEO 및 사이트 통계와 같은 도구가 새 프론트엔드의 데이터를 추적하기 시작합니다.
> * 이전 사이트에만 있던 페이지는 숨김 처리됩니다.
> * [지원되지 않는 앱](https://support.wix.com/ko/article/wix-headless-supported-and-unsupported-apps)은 새 프론트엔드에서 이용할 수 없지만, 대시보드에서는 계속 관리할 수 있습니다.

**전환하면 SEO와 사이트 통계는 어떻게 되나요?**

전환 전까지는 두 기능 모두 현재 사이트에 유지되며, 전환 후에는 새 프론트엔드로 자동 이전됩니다. 단, 페이지나 콘텐츠, 사이트 구조를 크게 변경하면 SEO에 영향을 줄 수 있습니다.

**Wix 플랜이 변경되나요?**

아니요. 프론트엔드를 구축하고 미리본 후 전환하는 동안에도 사이트의 현재 플랜이 유지됩니다.

**전환 후 이전 페이지의 일부 링크가 작동하지 않는 이유는 무엇인가요?**

전환 후에는 새 프론트엔드에서 구축한 페이지만 도메인에 게시됩니다. 이전 사이트에만 있던 페이지는 숨김 처리되므로 북마크, 검색 결과, 마케팅 캠페인 등에 포함된 해당 페이지의 링크를 열면 404 페이지가 표시됩니다.

기존 링크가 계속 작동하도록 이전 URL에서 새 프론트엔드의 해당 페이지로 연결되는 [301 리디렉트를 설정하세요](https://support.wix.com/ko/article/setting-up-a-301-redirect-for-a-page-on-your-site). 현재 사용 중인 URL 리디렉트 관리자를 그대로 이용할 수 있습니다. 사이트에서 Wix 다국어를 사용하는 경우 [언어별 리디렉트도 설정할 수 있습니다](https://support.wix.com/ko/article/setting-up-a-301-redirect-for-a-multilingual-site).

**Wix 양식을 계속 사용할 수 있나요?**

네. 제출 내역, 연락처, 오토메이션, 알림 이메일을 포함한 Wix 양식 기능은 대시보드에서 계속 실행됩니다. 단, 에디터에서 추가한 양식은 새 프론트엔드에 표시되지 않습니다. 

AI 코딩 도구 또는 개발자를 통해 새 프론트엔드에 양식을 다시 구축하고 [Wix Forms API](https://dev.wix.com/docs/api-reference/crm/forms/form-submissions/introduction)를 사용해 연결하세요. 이전 제출 내역은 삭제되지 않습니다.

**새 프론트엔드에서도 Wix 다국어를 사용할 수 있나요?**

네. AI 코딩 도구 또는 개발자를 통해 새 프론트엔드에 [다국어 기능을 추가할 수 있습니다](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/feature-guides/add-multilingual-support). 이후 대시보드에 있는 번역 관리자의 **헤드리스** 섹션에서 번역을 관리할 수 있습니다. 

이전 사이트의 번역은 자동으로 복사되지 않으므로 새 프론트엔드에 표시되는 콘텐츠를 번역해야 합니다.

**Wix Chat은 어떻게 되나요?**

Wix Chat 위젯은 새 프론트엔드에 표시되지 않으며, Wix 스마트 채팅은 [현재 지원되지 않습니다](https://support.wix.com/ko/article/wix-headless-supported-and-unsupported-apps). 두 기능 모두 사이트에 설치된 상태로 유지되며 대시보드에서 계속 관리할 수 있습니다.

방문자가 채팅할 수 있도록 하려면 개발자가 [AI 사이트 채팅 API](https://dev.wix.com/docs/api-reference/business-management/ai-site-chat/introduction)를 사용해 새 프론트엔드에 사용자 지정 채팅을 구축할 수 있습니다. 받은 편지함 및 Wix 앱에서 메시지에 계속 답장할 수 있습니다.

**중요!** 전환하기 전에 현재 사이트에 Wix 스마트 채팅을 설치하고 설정해야 합니다. 새 프론트엔드가 라이브 상태가 된 후에는 추가할 수 없습니다.

**Velo 코드는 어떻게 되나요?**

전환하면 방문자가 더 이상 기존 사이트의 페이지를 불러오지 않으므로 페이지의 Velo 코드 실행이 중지됩니다. 단, 백엔드 코드(예: HTTP 함수, 예약 작업, 데이터 후크)는 삭제되지 않습니다:

* 새 프론트엔드에서도 기존 [HTTP 함수](https://dev.wix.com/docs/go-headless/coding/java-script-sdk/calling-site-http-functions)를 호출할 수 있습니다.
* 페이지 코드 및 웹 모듈(.jsw 파일)은 새 프론트엔드에서 다시 구축해야 합니다.

기존 사이트로 다시 전환해도 Velo 코드는 그대로 유지됩니다.
