Shopify 관리자에는 AI로 바꾼 상품 설명이 있는데 실제 상품 페이지에 안 보인다면 설명을 다시 만들지 말고, 그 상품에 할당된 테마 템플릿과 Product information 안의 Description 블록부터 확인하세요. 설명 블록이 없거나 숨겨져 있으면 상품 데이터가 정상이어도 구매자 화면에는 표시되지 않습니다.
설명 블록이 있는데도 비어 보이면 블록이 기본 상품 설명이 아니라 메타필드 같은 동적 소스에 연결되어 있는지 확인합니다. 이 경우 관리자 상단의 Description을 수정해도, 테마가 다른 필드의 값을 불러오고 있으면 공개 페이지는 바뀌지 않습니다.
테마 편집기에서는 정상인데 실제 주소에서만 안 보인다면 초안 테마를 편집했을 가능성이 있습니다. 현재 공개된 테마의 정확한 상품 템플릿을 수정하고 저장한 뒤, 관리자에서 해당 상품의 Preview를 눌러 같은 상품 주소를 다시 확인하세요.
가장 빠른 확인 순서
- 상품 관리자에서 설명이 실제로 저장됐는지 확인합니다.
- 같은 화면의 Theme template에서 할당된 템플릿 이름을 확인합니다.
- 현재 공개 중인 테마에서 그 템플릿을 엽니다.
- Product information 안에 Description 블록이 있는지 확인합니다.
- 동적 소스와 판매 채널까지 확인한 뒤 상품 Preview로 검수합니다.
설명은 저장됐는데 화면에 없는 이유부터 나누세요
Shopify의 상품 관리자와 온라인 스토어 화면은 같은 역할을 하지 않습니다. 상품 관리자는 설명 데이터를 저장하고, 테마 템플릿은 그 데이터 중 무엇을 어느 위치에 보여줄지 정합니다. Shopify의 템플릿 안내도 상품 페이지의 Product information 섹션이 제목, 설명, 가격, 이미지 같은 정보를 표시한다고 설명합니다.
| 확인할 곳 |
맡는 역할 |
엇갈렸을 때 보이는 증상 |
| Products의 Description |
기본 상품 설명 저장 |
관리자에는 문장이 있지만 화면에는 없을 수 있음 |
| Theme template |
해당 상품이 사용할 화면 구성 선택 |
다른 템플릿을 고쳐도 특정 상품은 그대로임 |
| Description 블록 |
설명을 실제 페이지에 출력 |
블록 삭제·숨김 시 설명 전체가 사라짐 |
| 메타필드·동적 소스 |
상품마다 다른 추가 정보를 불러옴 |
기본 설명을 고쳐도 연결된 별도 필드만 표시됨 |
| 공개 테마·판매 채널 |
구매자가 실제로 보는 화면 결정 |
초안 미리보기와 실제 주소가 다르게 보임 |
따라서 AI가 설명을 잘못 썼는지와 설명이 화면에 출력되는지는 별개의 문제입니다. 문장이 관리자에 온전히 저장되어 있다면 생성 단계로 돌아가기보다 출력 경로를 따라가야 합니다. CSV 가져오기 직후 Description 자체가 비었다면 Shopify CSV의 설명 열과 덮어쓰기 범위를 확인하는 법을 먼저 적용하고, 설명에 소재·크기·용도만 빠진 경우에는 Shopify AI 상품 설명의 정보 누락을 고치는 법을 적용하세요.
문제가 생긴 바로 그 상품을 Preview로 여세요
홈 화면이나 테마 편집기의 예시 상품만 보면 다른 템플릿을 확인하기 쉽습니다. Shopify 관리자에서 Products → 문제가 생긴 상품 → Preview 순서로 열어 구매자에게 표시되는 상품 페이지를 먼저 확인하세요. Shopify의 상품 추가·수정 안내에도 상품 상세 화면에서 Preview를 눌러 온라인 스토어 표시 상태를 확인하는 절차가 나옵니다.
- 관리자에서 문제가 생긴 상품을 엽니다.
- Description에 수정한 문장의 첫 문장과 마지막 문장이 모두 있는지 확인합니다.
- 저장 버튼이 활성화되어 있다면 먼저 저장합니다.
- Preview를 새 탭으로 열고 상품 설명이 있어야 할 위치를 확인합니다.
- 페이지 전체가 열리지 않으면 설명 블록보다 상품 상태와 Publishing을 먼저 확인합니다.
이 단계에서 상품 페이지는 열리지만 설명 영역만 없다면 템플릿이나 블록 문제일 가능성이 큽니다. 페이지 자체가 없거나 다른 채널에서만 보인다면 상품 상태가 Active인지, Publishing에 Online Store가 포함되어 있는지 확인하세요. Shopify는 특정 판매 채널에서 제외된 상품은 그 채널에서 숨겨진다고 안내합니다.
상품에 실제로 할당된 템플릿 이름을 확인하세요
모든 상품이 Default product 템플릿을 쓰는 것은 아닙니다. 프로모션용, 예약 판매용, 상품군별 상세 구성처럼 별도 템플릿을 만든 상점이라면 일부 상품만 다른 템플릿을 사용할 수 있습니다. 그래서 기본 템플릿에 Description 블록을 추가해도 별도 템플릿이 할당된 상품에는 변화가 없습니다.
- Products에서 문제가 생긴 상품을 엽니다.
- 상품 상세 화면의 Theme template 드롭다운을 찾습니다.
- 현재 선택된 템플릿 이름을 적어 둡니다.
- Online Store → Themes에서 현재 공개된 테마의 Edit theme를 엽니다.
- 상단 템플릿 메뉴에서 Products와 적어 둔 템플릿을 선택합니다.
Shopify 상품 세부 정보 페이지 안내에 따르면 Theme template 드롭다운에는 그 상품이 현재 사용하는 템플릿이 표시됩니다. 별도 템플릿 선택지는 현재 공개 테마에 존재하는 템플릿을 기준으로 나타나므로, 초안 테마에만 만든 템플릿을 상품에 배정하려고 해도 같은 선택지가 보이지 않을 수 있습니다.
일부 상품만 설명이 안 보인다면
정상 상품과 문제 상품의 Theme template 이름을 나란히 비교하세요. 설명 문장보다 템플릿 이름이 다르면 원인을 훨씬 빨리 좁힐 수 있습니다.
Product information 안에서 Description 블록을 되살리세요
정확한 템플릿을 열었다면 왼쪽 구조에서 Product information을 펼칩니다. 그 안에 Description 블록이 있는지, 눈 모양이 꺼져 숨겨진 상태인지, 접을 수 있는 행이나 탭 안으로 옮겨졌는지 확인하세요. 테마마다 블록 이름과 지원 기능은 다를 수 있지만, 설명을 출력하는 블록이 페이지 구조 안에 있어야 한다는 기준은 같습니다.
- Description 블록이 있으면 선택해 숨김 상태와 설정을 확인합니다.
- 블록이 없다면 Product information의 Add block에서 Description을 찾습니다.
- 추가한 블록을 구매 버튼 아래나 상품 정보 흐름에 맞는 위치로 옮깁니다.
- 오른쪽 미리보기에서 문제가 생긴 상품이 선택되어 있는지 확인합니다.
- 변경 내용을 저장한 뒤 실제 상품 Preview를 다시 엽니다.
Shopify의 섹션 편집 안내에서 설명하듯 섹션과 블록은 테마 편집기에서 추가, 이동, 숨김, 삭제할 수 있습니다. 다만 사용 중인 테마가 Description 블록을 제공하지 않거나 구조가 크게 바뀐 테마라면 임의로 코드를 붙이기 전에 테마 개발자의 지원 범위를 확인하는 편이 안전합니다.
블록이 있는데 비어 있다면 동적 소스를 확인하세요
Description과 비슷한 위치에 Rich text, Collapsible row, Text 같은 블록을 두고 메타필드를 연결해 사용하는 상점도 많습니다. 이 블록이 상품 설명이 아니라 custom.product_details 같은 메타필드를 불러오도록 설정돼 있다면 Products 상단의 Description을 수정해도 해당 영역은 그대로 비어 있을 수 있습니다.
| 현재 연결 |
수정해야 할 곳 |
맞는 선택 |
| 기본 Description 블록 |
Products의 Description |
일반 상품 설명을 그대로 보여줄 때 |
| 상품 메타필드 |
해당 상품 아래쪽의 같은 메타필드 |
사이즈표·소재표처럼 별도 정보일 때 |
| 고정 텍스트 |
테마 편집기의 블록 내용 |
모든 상품에 같은 배송·안내문을 보여줄 때 |
블록 설정 옆의 동적 소스 아이콘을 눌러 어떤 필드가 연결되어 있는지 확인하세요. 원래 기본 상품 설명을 보여주려던 영역이라면 잘못 연결된 동적 소스를 해제하고 Description 블록을 사용합니다. 별도 메타필드를 보여주려던 영역이라면 연결은 유지하고 문제가 생긴 상품의 해당 메타필드 값을 채웁니다.
Shopify는 호환되는 테마에서 메타필드를 테마 편집기에 연결해 상품이나 변형별 정보를 표시할 수 있다고 안내합니다. AIZip(www.aizip.ai.kr)은 이 문제를 확인할 때 먼저 “AI 문장이 어느 필드에 저장됐는가”와 “테마 블록이 어느 필드를 읽는가”를 한 줄로 적어 서로 맞는지 비교합니다.
미리보기만 정상이라면 공개 중인 테마를 확인하세요
Shopify에는 여러 테마를 보관할 수 있지만 구매자가 보는 테마는 한 번에 하나입니다. 초안 테마에서 Description 블록을 되살리면 그 테마의 미리보기에는 보이지만, 공개 상품 주소는 아직 현재 테마의 구성을 사용합니다.
- Online Store → Themes에서 Current theme 또는 Live 표시를 찾습니다.
- 방금 수정한 테마가 공개 테마와 같은지 확인합니다.
- 초안 테마를 시험 중이라면 미리보기 주소와 실제 상품 주소를 구분합니다.
- 초안 테마 전체를 공개할 계획이 없다면 현재 테마에도 필요한 변경을 적용합니다.
- 새 테마를 공개할 계획이라면 상품 페이지와 장바구니까지 검수한 뒤 Publish합니다.
Shopify의 테마 공개 안내는 공개 테마가 고객이 온라인 스토어에 방문할 때 보는 테마이며, 공개되지 않은 테마는 Draft themes에 표시된다고 설명합니다. 설명 한 블록을 고치기 위해 준비되지 않은 초안 테마 전체를 바로 공개하지 말고, 현재 테마를 수정할지 새 테마 전환을 완료할지 먼저 결정하세요.
온라인 스토어와 Shop 앱은 같은 화면이 아닙니다
온라인 스토어 상품 페이지는 정상인데 Shop 앱에서 구성이 다르게 보인다면 테마 오류로 단정하면 안 됩니다. Shop 채널의 상품 노출과 구매 방식은 별도로 관리되며, 온라인 스토어 테마의 모든 블록 구성이 Shop 앱에 그대로 복제되는 것은 아닙니다.
먼저 지금 확인 중인 주소가 상점의 온라인 스토어 도메인인지 Shop 앱의 상품 화면인지 구분하세요. Shopify의 Shop 상품 관리 안내에 따르면 Shop 채널에서 공개하지 않은 상품도 Shopify Catalog에 포함되어 있으면 Shop에 보이고 온라인 스토어 구매 화면으로 연결될 수 있습니다. 두 화면의 표시 차이는 각각의 채널에서 확인해야 합니다.
테마 앱이나 코드가 설명 영역을 바꿨다면 백업부터 하세요
Description 블록을 추가할 수 없거나 저장 후 다시 사라지고, 같은 템플릿의 모든 상품에서 문제가 반복된다면 설치한 페이지 빌더·상품 탭 앱·테마 코드가 출력 구조를 바꿨을 수 있습니다. 이때는 설명 문장을 계속 고치는 것으로 해결되지 않습니다.
- 현재 테마를 복제해 되돌릴 수 있는 사본을 만듭니다.
- 문제가 시작된 시점에 설치·업데이트한 앱이 있는지 확인합니다.
- 앱 블록이 상품 설명을 대신 출력하는지 확인합니다.
- 테마 개발자에게 상품 URL, 템플릿 이름, 사라진 블록 이름을 전달합니다.
- Liquid와 JSON 템플릿 구조를 모르면 공개 테마 코드를 바로 삭제하지 않습니다.
지원 요청에는 “설명이 안 보입니다”만 쓰기보다 재현 정보를 짧게 묶는 편이 좋습니다. 아래 형식에서 계정 정보와 고객 정보는 빼고, 공개 상품 주소와 화면 구성 정보만 전달하세요.
문제가 생긴 공개 상품 URL: [주소]
상품에 할당된 Theme template: [이름]
현재 공개 테마: [테마 이름과 버전]
Products의 Description 저장 여부: [있음/없음]
Product information의 Description 블록: [있음/없음/숨김]
연결된 동적 소스: [없음 또는 메타필드 이름]
정상인 비교 상품 URL: [있다면 주소]
문제가 시작된 시점: [앱 설치·테마 변경 전후]
수정한 뒤에는 세 화면만 비교하면 됩니다
설명 표시를 고친 뒤에는 관리자 편집 화면, 테마 편집기, 공개 상품 주소를 차례로 비교하세요. 세 화면에서 같은 상품과 같은 템플릿을 보고 있어야 수정 결과를 정확히 판단할 수 있습니다.
- Products: 수정한 설명의 첫 문장과 마지막 문장이 저장돼 있는가
- Theme editor: 정확한 템플릿에 Description 블록이 보이는가
- Public product page: 데스크톱과 모바일에서 설명이 펼쳐지고 읽히는가
- Variants: 옵션을 바꿔도 설명과 상품 정보가 어긋나지 않는가
- Publishing: Online Store에서 상품을 실제로 볼 수 있는가
설명 영역은 보이지만 <p> 같은 태그가 글자로 나오거나 줄바꿈·목록만 깨진다면 표시 블록을 더 수정할 문제가 아닙니다. 그때는 Shopify 상품 설명의 HTML 코드와 서식 오류를 고치는 순서에서 HTML 보기, 숨은 서식과 테마 표시를 나눠 확인하세요. 설명 내용 자체가 부족하다면 구매자가 확인할 크기·구성품·주의점을 별도로 보완합니다.
상품 설명 영역은 보이지만 서로 다른 상품에 같은 문구가 반복된다면 표시 누락이 아니라 공통 템플릿 값의 문제일 수 있습니다. 이 경우 Shopify 여러 상품에 같은 AI 설명이 반복될 때 템플릿 고정 문구와 동적 소스를 확인하는 순서로 점검하세요.
자주 묻는 질문
관리자에는 설명이 있는데 상품 페이지에 안 보이는 가장 흔한 이유는 무엇인가요?
해당 상품에 할당된 템플릿의 Product information 안에 Description 블록이 없거나 숨겨진 경우가 많습니다. 상품의 Theme template 이름을 확인한 뒤 정확히 같은 템플릿에서 설명 블록을 찾으세요.
일부 상품에서만 설명이 안 보이는 이유는 무엇인가요?
정상 상품과 문제 상품에 서로 다른 템플릿이 할당됐거나, 설명 영역이 상품별 메타필드에 연결되어 있을 수 있습니다. 두 상품의 Theme template과 연결된 동적 소스를 나란히 비교하세요.
테마 편집기에서는 보이는데 실제 상점에서는 왜 안 보이나요?
공개되지 않은 초안 테마를 편집했을 가능성이 있습니다. Online Store의 Themes에서 Current theme 또는 Live 표시를 확인하고, 현재 공개 테마의 같은 상품 템플릿을 수정했는지 확인하세요.
Shop 앱과 온라인 스토어의 상품 설명 화면이 달라도 되나요?
네. Shop 채널과 온라인 스토어는 상품을 보여주는 화면과 관리 방식이 다를 수 있습니다. 온라인 스토어 테마의 블록 구성이 Shop 앱에 그대로 표시된다고 가정하지 말고 각 채널에서 따로 확인하세요.
설명이 안 보일 때 AI로 다시 작성하면 해결되나요?
관리자에 설명이 이미 저장돼 있다면 다시 작성해도 해결되지 않습니다. 먼저 템플릿, Description 블록, 동적 소스와 공개 테마가 같은 상품 설명을 가리키는지 확인하세요.
댓글
댓글 쓰기