메르카도리브레 이미지 규격: 진짜 기준선은 800px

메르카도리브레 이미지 규격을 공식 판매자·개발자 문서 기준으로 정리했습니다: 500~1,920px 크기 범위, 800px 확대(줌) 활성화 기준, 카테고리별 이미지 개수 상한, 사이즈 차트 등록 규정까지 전부 다룹니다.

메르카도리브레 이미지 규격: 진짜 기준선은 800px

메르카도리브레 이미지 규격에는 500 × 500px라는 공식 최소 기준이 있는데, 이 숫자가 함정입니다. 정확히 500px인 이미지는 업로드도 매끄럽게 되고 경고도 뜨지 않지만, 확대(줌) 기능 없이 조용히 게시됩니다. 줌은 너비 800px를 넘어야만 작동하기 때문입니다. API 응답 어디에도 이 사실을 알려주지 않습니다. 결과적으로 옆 판매자보다 전환율이 떨어지는데, 이유를 끝내 알지 못하게 됩니다.

이 글은 메르카도리브레 공식 판매자·개발자 문서가 실제로 규정하는 이미지 규격, 카테고리별로 재량에 맡긴 부분, 그리고 해외 판매자가 막히는 지점을 정리한 것입니다.

메르카도리브레 이미지 규격 한눈에 보기

항목 요구사항 출처
최소 허용 크기 500 × 500px ("M" 버전) 이미지 다루기
최대 허용 크기 1,920 × 1,920px ("F" 버전) 이미지 다루기
더 큰 업로드 자동으로 F 버전 크기로 축소됨 이미지 다루기
더 작은 업로드 원본 그대로 유지 — 플랫폼이 확대하지 않음 이미지 다루기
줌 활성화 너비 800px를 초과하는 이미지는 마우스 오버 시 줌 위젯이 활성화됨 이미지 다루기
파일 크기 제한 이미지당 최대 10MB 이미지 다루기
지원 형식 JPG, JPEG, PNG 이미지 다루기
색상 공간 CMYK보다 RGB를 강력히 권장 이미지 다루기
상품당 이미지 개수 전체가 아니라 카테고리별로 상한이 정해짐 이미지 다루기 / CBT FAQ
옵션(변형) 이미지 동일한 카테고리 상한에 포함되어 계산됨 CBT 이미지 FAQ
업로드 전 검증 스마트크롭 검증 엔드포인트가 크기를 확인하고 여백을 잘라냄 이미지 다루기

실무적으로 정리하면 이렇습니다. 긴 변 기준 1,200~1,920px 사이의 정사각형 이미지를, RGB JPG로, 10MB 미만으로 촬영해 내보내십시오. 이렇게 하면 줌 기준선은 넘고, 리사이즈 상한은 넘지 않으며, 형식 규정도 한 번에 모두 충족합니다.

메르카도리브레 이미지 규격 중 구매자의 줌 가능 여부를 결정하는 기준선: 800px

메르카도리브레 개발자 문서는 이를 명확히 밝히고 있습니다. 너비 800픽셀을 초과하는 이미지는 줌 위젯이 활성화되어 구매자가 마우스를 올려 확대해서 볼 수 있으며, 특히 의류 카테고리에는 강력히 권장한다고 명시합니다.

이 한 문장이 나머지 스펙 전체보다 더 많은 매출을 좌우합니다. 줌 기능은 구매자가 질문하지 않고도 봉제선, 마감, 인쇄된 치수, 질감을 확인할 수 있게 해줍니다. 줌이 없는 게시물은 이런 확인 과정을 모두 문의창으로 떠넘기거나, 아니면 애초에 반품을 염두에 둔 구매로 이어지게 만듭니다.

핵심적인 구분은 이렇습니다.

  • 500px는 플랫폼이 받아주는 기준입니다.
  • 800px는 구매자에게 돋보기(줌)를 제공하기 위해 필요한 기준입니다.
  • 1,920px는 상한선이며, 이를 넘으면 어차피 파일이 리사이즈됩니다.

"요구사항이니까"라는 이유로 500px에 맞춰 촬영하는 것은 이 마켓플레이스에서 가장 흔한 자충수입니다. 패널티 메시지도, 이를 지적하는 품질 표시도, 거부도 없습니다. 그저 줌 기능이 아예 나타나지 않을 뿐입니다.

이미지 개수 상한은 카테고리별이며, 옵션(변형)도 여기에 합산됩니다

바로 이 지점에서 해외 판매자들은 재현할 수 없는 오류를 마주하게 됩니다.

상품당 최대 이미지 개수는 플랫폼 전체에 적용되는 단일 숫자가 아니라 카테고리별로 정해집니다. 그리고 메르카도리브레의 자체 해외거래(CBT) FAQ에 따르면, 이미지는 최상위 pictures 배열뿐 아니라 옵션(변형)에서도 함께 집계됩니다. 따라서 두 곳 모두에 이미지를 넣으면, 업로드한 갤러리는 적어 보여도 실제 합산 개수는 카테고리 상한을 넘을 수 있습니다. 오류 메시지는 "Items in category … cannot exceed X pictures"처럼 뜨는데, 버그처럼 보이지만 버그가 아닙니다.

플랫폼이 문서화한 세 가지 실패 유형:

증상 실제 원인 해결 방법
업로드한 이미지 수가 더 적은데도 "Cannot exceed X pictures" 오류 발생 최상위 이미지와 각 옵션의 이미지가 모두 합산됨 게시 전에 실제 합산 이미지 개수를 계산하고, 필요한 곳에만 이미지를 배치
이전에는 문제없던 게시물이 업데이트 시 실패하기 시작함 해당 카테고리의 이미지 상한이 축소됨 현재 카테고리 제약 기준으로 활성 게시물을 재검증하고, 갤러리를 줄이거나 옵션이 많은 상품을 여러 게시물로 분리
이미지를 전혀 건드리지 않은 옵션 업데이트에서도 이미지 상한 오류 발생 옵션의 부분 업데이트가 다른 옵션을 암묵적으로 삭제하여, 새로운 구조 기준으로 제약이 재계산됨 옵션 업데이트는 항상 전체 교체로 처리 — 현재 옵션을 읽고, 메모리상에서 수정한 뒤, 전체 배열을 PUT으로 다시 전송

운영 원칙은 이렇습니다. 게시 프로세스에 '실제 합산 이미지 수' 카운터를 넣고, API를 호출하기 전에 가장 엄격한 카테고리 상한을 강제하십시오. 이런 마켓플레이스별 차이 때문에 하나의 내보내기 설정이 모든 곳에서 통하는 경우는 거의 없습니다 — 같은 패턴이 테무(Temu) 상품 이미지 요구사항에서도 나타납니다.

거부가 아니라 감점: 게시물 품질 점수가 사진을 읽는 방식

메르카도리브레는 게시물 품질을 점수로 매겨 판매자에게 공개합니다. 예전의 /health API는 폐지되는 추세이며, 점수·등급·남은 조치사항을 함께 반환하는 /performance가 이를 대체하고 있습니다.

등급 명칭은 사이트마다 다릅니다. CBT에서는 Basic, Standard, Professional이며, 아르헨티나 사이트에서는 Básica, Estándar, Profesional, 브라질 사이트에서는 Básica, Satisfatória, Profissional로 표기됩니다.

사진은 이 점수에서 독립된 항목으로 다뤄지며, 그 규칙 중 하나가 최소 이미지 개수 검사입니다. 이미지가 너무 적은 게시물은 '보류' 상태로 표시되고, 방문자를 늘리려면 사진을 개선하라는 안내가 뜹니다. 즉, 기술적으로는 문제없는 이미지 갤러리라도 노출에서 손해를 볼 수 있습니다. 규정 준수는 최소 기준일 뿐이고, 실제 순위를 좌우하는 것은 점수입니다.

사이즈 차트: 수출업체가 뒤늦게 발견하는 요구사항

패션 카테고리에서 메르카도리브레는 사이즈 차트를 표 이미지가 아니라 구조화된 객체로 다룹니다. 이 차이 때문에, 지금까지 다섯 번째 이미지로 JPEG 사이즈 표를 올려온 판매자들이 발목을 잡히게 됩니다.

문서가 요구하는 사항은 다음과 같습니다.

  • 차트는 SPECIFIC(판매자가 생성)이거나 BRAND(브랜드가 미리 설정)여야 합니다.
  • 차트는 SIZE_GRID_ID 속성을 통해 상품에 연결되며, 각 옵션은 해당 행을 가리키는 SIZE_GRID_ROW_ID를 가지고 있어야 합니다. 행 ID 없이는 차트를 연결할 수 없습니다.
  • 차트 이름은 고유해야 하고 최대 60자로 제한되며, 사이트마다 번역하지 않고 그대로 재사용됩니다.
  • 차트의 성별은 상품의 성별과 일치해야 합니다.
  • 상품을 생성한 사용자와 차트를 생성한 사용자는 동일해야 합니다.
  • 이 카테고리의 상품 등록에는 제목(최대 60자), 카테고리, 가격, 상태, 이미지, 판매 조건과 더불어 PACKAGE_WEIGHT, PACKAGE_LENGTH, PACKAGE_WIDTH, PACKAGE_HEIGHT 등 패키지 치수도 함께 요구됩니다.

이것이 그저 행정 절차라고 여기는 이들에게 반복해서 말할 가치가 있는, 명시된 목적은 간단합니다. 사이즈 차트는 구매자가 올바르게 선택하도록 하여 교환과 클레임을 줄이기 위해 존재합니다. 구조화된 차트는 기계가 읽을 수 있고, 필터링이 가능하며, 선택 시점에 바로 노출됩니다. 차트 이미지는 이 중 어느 것도 할 수 없습니다.

차트가 아직 센티미터 단위나 미국 사이즈 단위로만 되어 있다면, 변환 과정의 함정은 국제 사이즈 변환표에 정리되어 있습니다 — 그리고 잘못된 사이즈가 주문 한 건당 얼마나 비용을 유발하는지는 반품 비용 계산기로 확인할 수 있습니다.

게시물이 막히거나 약해지는 흔한 원인

원인 발생 결과 예방법
정확히 500px인 이미지 허용은 되지만 줌 없음, 경고도 없음 1,200~1,920px 사이로 내보내기
1,920px 초과 이미지 조용히 리사이즈됨 상한선에 맞춰 내보내되 그 이상은 하지 않기
CMYK 파일 마켓플레이스에서 색상이 틀어짐 내보내기 전 RGB로 변환
10MB 초과 파일 업로드 거부 압축 — 이 크기대에서는 JPG 품질 80~90이면 충분
최상위 이미지 + 옵션 이미지 합산 카테고리 상한 오류 게시 전 실제 합산 개수 계산
옵션 부분 업데이트 암묵적 삭제, 제약 재계산, 오류 발생 항상 전체 옵션 배열을 PUT으로 전송
JPEG로 만든 사이즈 차트 구조화되지 않아 교환 증가 SPECIFIC 또는 BRAND 차트를 만들고 모든 옵션 행을 매핑
이미지 개수 부족 게시물 품질 하락, 노출 하락 /performance에서 이미지 항목 확인

가장 먼저 고쳐야 할 것

처음부터 새로 시작하는 게 아니라 기존 카탈로그를 점검하는 경우라면, 다음 순서대로 진행하십시오 — 첫 번째 항목이 나머지 전체의 효과를 좌우합니다.

  1. 800px를 넘도록 전체를 재내보내기 하십시오. 한 번의 일괄 작업으로 카탈로그 전체 줌 기능에 즉시 효과가 나타납니다.
  2. 모든 활성 게시물에 대해 실제 합산 이미지 개수를 계산하고 현재 카테고리 상한과 비교하십시오. 한 번의 업데이트만으로도 실패할 위험이 있는 게시물을 먼저 수정하십시오.
  3. 패션 카테고리의 모든 게시물에서 JPEG 사이즈 표를 구조화된 사이즈 차트로 전환하십시오.
  4. SKU마다 치수 이미지를 하나씩 추가하십시오. 사이즈 차트가 아니라, 실측한 너비·깊이·높이와 필요한 경우 패키지 치수를 제품 위에 직접 표시한 이미지를 말합니다. 이는 구매자가 어차피 문의로 물어볼 질문에 미리 답해주는 이미지이며, 대부분의 카탈로그에 아예 빠져 있는 항목입니다.

이 네 번째 항목을 실현하는 현실적인 방법은 세 가지입니다. SKU마다 디자이너에게 작업을 맡길 수 있지만, 정확한 대신 규모를 키우기 어렵습니다. 일반 사진 편집기에서 화살표를 수작업으로 그릴 수도 있지만, 이미지를 다른 크기로 재내보내는 순간 깨지고 라벨이 엉뚱한 곳을 가리키게 됩니다. 아니면 이를 위해 만들어진 전용 소프트웨어를 쓸 수 있습니다 — 사진 속 제품의 실제 가장자리에 치수선을 정확히 맞추고, 리사이즈를 거쳐도 측정값이 그 선에 고정된 채 유지되며, 각 마켓플레이스가 요구하는 치수에 맞춰 같은 주석 이미지를 내보내는 방식입니다. AI 이미지 생성기와의 차이는 여기서 중요해집니다. 생성기는 실제로 측정된 적 없는, 그럴듯해 보이는 숫자를 만들어낼 뿐이며, 마켓플레이스에서 이는 지름길이 아니라 반품 부담으로 돌아옵니다. 치수 이미지를 견적서나 카탈로그에도 함께 쓸 계획이라면, 재사용 가능한 레이아웃은 스펙 시트 가이드에 정리되어 있습니다.

메르카도리브레 게시물 업로드 전 체크리스트

  • 모든 이미지가 긴 변 기준 1,200~1,920px 사이인지 확인
  • RGB 색상 공간 확인, CMYK 아님
  • 각 파일이 10MB 미만이며 JPG/JPEG/PNG만 사용
  • 최상위 이미지와 모든 옵션 이미지를 합산해 카테고리 상한 이내인지 확인
  • 옵션 업데이트는 항상 전체 배열로 전송, 부분 업데이트 금지
  • 해당 카테고리 고유의 사진 규정을 그 카테고리의 도움말 문서에서 확인
  • 구조화된 사이즈 차트를 생성하고 모든 옵션을 각 행에 매핑
  • 차트 성별이 상품 성별과 일치하는지, 차트를 게시자와 동일한 사용자가 만들었는지 확인
  • 패키지 무게와 길이·너비·높이 입력 완료
  • 제목이 60자 이내인지 확인
  • 최소 하나의 이미지에 실측 치수가 표시되어 있는지 확인
  • 게시 후 /performance로 게시물 품질 확인 (게시 전이 아니라 후)

FAQ

메르카도리브레 상품 사진은 어떤 크기여야 하나요?

긴 변 기준 1,200~1,920px 사이가 적절합니다. 공식 문서상 최소 크기는 500 × 500px, 최대 허용 크기는 1,920 × 1,920px이지만, 줌 위젯이 작동하려면 너비가 800px를 넘어야 하며, 1,920px를 넘는 이미지는 어차피 자동으로 축소됩니다. 정사각형 형식, RGB, 10MB 미만이어야 합니다.

메르카도리브레 게시물에는 사진을 몇 장까지 올릴 수 있나요?

정해진 단일 숫자는 없으며, 최대치는 카테고리별로 다릅니다. 해당 카테고리의 상한을 확인하고, 옵션에 연결된 이미지도 메인 갤러리 이미지와 동일한 상한에 포함되어 계산된다는 점을 기억하십시오.

이미지를 4장만 올렸는데 왜 메르카도리브레가 이미지 상한 초과라고 하나요?

옵션 이미지도 함께 집계되기 때문입니다. 최상위 배열과 각 옵션 안에 모두 이미지를 넣으면, 실제 합산 개수는 그 전부를 더한 값이 됩니다. 갤러리 이미지 4장에 옵션 6개가 각각 이미지 2장씩 갖고 있는 상품이라면, 실제로는 4장이 아니라 16장을 전송하는 셈입니다.

메르카도리브레는 사이즈 차트를 반드시 요구하나요?

패션 카테고리에서는 그렇습니다. 그리고 이미지가 아니라 구조화된 차트여야 합니다. 상품에는 SIZE_GRID_ID로 연결되고, 각 옵션에는 SIZE_GRID_ROW_ID가 필요하며, 차트 성별은 상품 성별과 일치해야 하고, 차트는 게시자와 동일한 사용자가 생성해야 합니다.

다른 마켓플레이스에서 쓰던 이미지를 그대로 재사용할 수 있나요?

촬영한 사진 자체는 대체로 재사용할 수 있지만, 내보내기 설정은 거의 그렇지 않습니다. 마켓플레이스마다 최소·최대 크기, 줌 기준선, 파일 크기 상한, 카테고리별 개수 제한이 모두 다르므로, 안전한 방법은 촬영본마다 고화질 마스터 파일 하나를 두고 마켓플레이스별로 내보내기 프리셋을 따로 만드는 것입니다 — 한 폴더의 파일을 모든 곳에 그대로 밀어 넣는 방식은 피해야 합니다.

출처 / Sources & References

상품 사진에 몇 분이면 정확한 치수·규격을 표시정확한 치수·규격 · 무료무료로 시작
메르카도리브레 이미지 규격: 진짜 기준선은 800px