본문으로 건너뛰기

연결(Linking) 문제 해결

PDF를 리소스(상품/페이지/컬렉션 등)에 연결할 때 자주 발생하는 문제와 해결 방법을 정리했습니다.

연결할 리소스를 찾을 수 없음​

검색이 잘 안 되는 경우:

  • 전체 이름이 아니라 일부만 입력해도 됩니다.
  • 검색은 대/소문자를 구분하지 않습니다.
  • 리소스 이름에서 다른 키워드로 시도해 보세요.

리소스가 존재하지 않는 경우:

  • Shopify에서 상품/페이지/컬렉션이 실제로 존재하는지 확인합니다.
  • 리소스가 게시(Published) 상태인지 확인합니다(초안/Draft는 보이지 않을 수 있음).
  • 아카이브(Archived)된 리소스는 표시되지 않습니다.

리소스 유형을 잘못 선택한 경우:

  • 올바른 유형(상품 vs 페이지 등)을 선택했는지 확인합니다.
  • 드롭다운에서 리소스 유형을 바꿔 다시 검색해 보세요.

연결은 된 것 같은데 PDF가 표시되지 않음​

3가지 필수 조건 확인:

  1. ✅ PDF가 연결되어 있음(이미 진행)
  2. ⚠️ PDF 상태가 Active인지 확인 필요
  3. ⚠️ 테마에 Theme App Extension이 추가되어 있는지 확인 필요

표시 문제 해결 →

여전히 연결된 것처럼 보이는 경우:

  • 페이지를 새로고침합니다.
  • 링크가 실제로 제거되었는지 확인합니다.
  • 다시 연결 해제를 시도합니다.

일괄 연결 해제(bulk unlink)가 실패하는 경우:

  • 1개씩 연결 해제를 시도해 보세요.
  • 권한(permissions)을 확인하세요.
  • 문제가 계속되면 지원팀에 문의하세요.

잘못된 PDF가 리소스에 연결됨​

해결 방법:

  1. 잘못 연결된 PDF를 연결 해제(Unlink)합니다.
  2. 올바른 PDF를 다시 연결합니다.
  3. PDF 상태가 Active인지 확인합니다.
  4. 스토어프론트에서 표시를 확인합니다.

여러 PDF가 함께 연결된 경우:

  • 여러 PDF가 연결되어 있는지 확인합니다.
  • 원치 않는 PDF는 연결을 해제합니다.
  • 올바른 PDF만 남겨두세요.

일괄 연결(Bulk linking)이 동작하지 않음​

리소스가 너무 많은 경우:

  • 더 작은 배치(한 번에 25~50개)로 나눠 시도해 보세요.
  • 대규모 작업은 더 오래 걸릴 수 있습니다.
  • 백그라운드 처리 완료를 기다려 보세요.

리소스를 선택하지 않은 경우:

  • 체크박스가 선택되어 있는지 확인합니다.
  • 최소 1개 리소스를 선택해야 합니다.
  • 확정하기 전에 선택 항목을 다시 검토하세요.

작업 타임아웃:

  • 매우 큰 일괄 작업은 타임아웃이 발생할 수 있습니다.
  • 더 작은 배치로 나눠 처리하세요.
  • 트래픽이 적은 시간대에 다시 시도해 보세요.

링크(연결) 수가 이상하게 표시됨​

캐시 지연:

  • 링크 수는 몇 분 간격으로 업데이트될 수 있습니다.
  • 페이지를 새로고침하고 잠시 기다려 보세요.
  • 숫자는 자동으로 갱신됩니다.

모든 리소스 유형을 포함:

  • 링크 수는 모든 리소스에 대한 연결을 합산한 값입니다.
  • PDF 1개가 상품과 페이지에 동시에 연결될 수 있습니다.
  • 정상 동작입니다.

홈페이지/검색 페이지에 연결할 수 없음​

연결 방식이 다름:

  • 홈페이지/검색 페이지는 검색이 필요 없습니다.
  • 리소스 유형을 선택하고 Link만 누르면 됩니다.
  • 스토어당 각각 1개만 존재합니다.

이미 연결되어 있음:

  • PDF가 이미 연결되어 있는지 확인합니다.
  • 다시 연결하려면 먼저 연결을 해제(Unlink)하세요.
  • PDF 1개는 리소스당 1회 연결됩니다.

템플릿 필터 때문에 PDF가 표시되지 않음​

필터가 너무 제한적인 경우:

  • 템플릿 이름이 정확한지 확인합니다.
  • 해당 페이지가 그 템플릿을 사용 중인지 확인합니다.
  • 필터를 제거하고(필터 없이) 먼저 테스트해 보세요.

템플릿이 존재하지 않는 경우:

  • 테마 코드에서 템플릿 이름을 확인합니다.
  • 템플릿 이름은 대/소문자를 구분할 수 있습니다.
  • 우선 필터 없이 테스트해 보세요.

템플릿 알아보기 →

업데이트 후 링크가 사라짐​

PDF를 삭제한 경우:

  • PDF를 삭제하면 모든 링크가 제거됩니다.
  • 삭제는 되돌릴 수 없습니다.
  • 다시 업로드했다면 재연결이 필요합니다.

실수로 연결 해제한 경우:

  • PDF 라이브러리에서 연결 상태를 확인합니다.
  • 필요하면 다시 연결하세요.
  • 여러 리소스라면 일괄 연결(Bulk linking)을 활용하세요.

특정 상품에 연결할 수 없음​

상품 상태가 원인일 수 있습니다:

  • 아카이브됨(먼저 다시 활성화)
  • 초안(Draft)(먼저 게시)
  • 삭제됨(삭제된 상품에는 연결할 수 없음)

상품 존재 여부 확인:

  • Shopify 관리자에서 검색합니다.
  • 알고 있다면 상품 ID도 확인합니다.
  • 게시 상태인지 확인하세요.

일괄 연결을 잘못된 리소스에 해버림​

일괄 작업 되돌리기:

  1. 같은 PDF를 선택합니다.
  2. 일괄 연결 해제(bulk unlink) 기능을 사용합니다.
  3. 같은 리소스를 선택합니다.
  4. 모두 연결 해제합니다.

실수 예방:

  • 확정 전에 선택 항목을 꼭 검토하세요.
  • 먼저 2~3개 리소스로 테스트해 보세요.
  • 필터로 선택 범위를 좁히세요.
  • 최종 확정 전에 미리보기를 확인하세요.

링크 한도에 도달했다는 오류가 뜸​

링크 자체의 한도는 없습니다:

  • PDF 1개를 무제한 리소스에 연결 가능
  • 1개 리소스에 무제한 PDF 연결 가능
  • 따라서 이 오류는 보통 발생하지 않습니다.

플랜 PDF 한도일 수 있습니다:

  • 현재 PDF 개수와 플랜 한도를 확인합니다.
  • 플랜 업그레이드 또는 PDF 삭제가 필요할 수 있습니다.
  • 링크(연결)는 무제한입니다.

연결을 잘하는 팁​

검색을 효율적으로:

  • 이름 일부로 검색하세요.
  • 다른 키워드도 시도하세요.
  • 가능하다면 유형별 필터를 활용하세요.

확정 전에 확인:

  • 리소스 이름을 확인하세요.
  • 리소스 유형이 맞는지 확인하세요.
  • 템플릿 필터를 사용 중이라면 설정을 다시 확인하세요.

먼저 테스트:

  • 리소스 1개에 먼저 연결합니다.
  • 스토어프론트에서 정상 표시되는지 확인합니다.
  • 그 다음 일괄 작업을 진행합니다.

정리 습관:

  • PDF 이름을 명확하게 정하세요.
  • 네이밍 규칙을 일관되게 유지하세요.
  • 어떤 PDF가 어디에 연결되는지 기록해 두세요.

다음 단계​