# 속성

***

<figure><img src="https://3639913499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnmQcxJVYbkAeUq7yQCkF%2Fuploads%2Fgit-blob-c44f177f3858db0a3f78a36ac2b0c0286f2e7821%2Fimage%20(191).png?alt=media" alt="박스히어로 속성 설명"><figcaption></figcaption></figure>

***

## 사용 예시 <a href="#location-example" id="location-example"></a>

<figure><img src="https://3639913499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnmQcxJVYbkAeUq7yQCkF%2Fuploads%2Fgit-blob-8373cd54d353063b6a008c10658683627e078e3b%2Fframeit_2026-03-25T15-57-22%20(1).jpg?alt=media" alt="제품 상세 정보에서 속성이 보여지는 영역"><figcaption></figcaption></figure>

* 제품명은 같지만 컬러, 사이즈 등 **옵션**을 구분해 관리할 때
* 브랜드, 카테고리 등 **세부 정보**를 추가할 때
* 제품에 **메모란**이 필요할 때
* 도면, 제품 설명서, 인증서 등 **파일 첨부**가 필요할 때
* 대표 사진 외 **추가 사진**을 등록하고 싶을 때

{% hint style="warning" %}
SKU, 제품명, 바코드, 구매가, 판매가는 고정 필드이며, 삭제하거나 이름을 수정할 수 없습니다.
{% endhint %}

## 속성 추가 <a href="#add-attributes" id="add-attributes"></a>

속성은 `데이터 관리` > `속성`에서 추가할 수 있으며 모든 제품에 **공통으로 적용**됩니다.

<figure><img src="https://3639913499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnmQcxJVYbkAeUq7yQCkF%2Fuploads%2Fgit-blob-7830aea6084635a1c95baf25b4839b05462baef8%2Fframeit_2026-03-25T15-58-46.jpg?alt=media" alt="속성 설정하는 방법 미리보기"><figcaption></figcaption></figure>

#### 속성 종류 <a href="#attribute-type" id="attribute-type"></a>

속성 종류에 따라 입력할 수 있는 데이터 형식이 다릅니다. 아래 표를 참고해 주세요.

<table><thead><tr><th width="113.8253173828125">종류</th><th width="321.4176025390625">설명</th><th>예시</th></tr></thead><tbody><tr><td><strong>텍스트</strong></td><td>문자, 숫자, 특수문자를 자유롭게 입력</td><td>abc, 가나다, 50%, 0.5, 100개</td></tr><tr><td><strong>숫자</strong></td><td>정수, 소수점 입력</td><td>1000, 0.5</td></tr><tr><td><strong>날짜</strong></td><td>연도-월-일 형식으로 입력 (달력 선택)</td><td>2025-03-01</td></tr><tr><td><strong>바코드</strong></td><td>바코드 추가 등록</td><td>제품에 바코드가 1개 이상 부착되어 있을 때</td></tr><tr><td><strong>파일</strong></td><td>최대 10MB 파일 첨부 가능</td><td>제품 관련 파일이나 추가 사진을 등록</td></tr></tbody></table>

#### 속성 순서 <a href="#attribute-sorting" id="attribute-sorting"></a>

`제품목록`, `입고`, `출고` 등에서 제품 속성은 `데이터 관리` > `속성`에 설정된 정렬 순서대로 표시됩니다.

목록에서 **원하는 속성만 표시**하려면 `설정` > `팀 설정` > `표시 설정` > `제품 정보`에서 설정할 수 있습니다. 여기서 '사용자 정의'를 선택하면 SKU, 바코드를 함께 표시하거나 일부 속성만 선택해 표시할 수 있습니다.

<figure><img src="https://3639913499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnmQcxJVYbkAeUq7yQCkF%2Fuploads%2Fgit-blob-641d9b3d6f60b185e061a3cf983e48e32f1fdddd%2Fimage.png?alt=media" alt="제품 목록에서 속성이 표시된 화면"><figcaption></figcaption></figure>

{% hint style="info" %}
제품 상세 정보에서는 항상 모든 속성이 표시됩니다. 특정 멤버에게 일부 속성을 숨기려면 [커스텀 권한](https://www.boxhero.io/docs/documentation/ko/etc/settings/members#custom-permissions)을 사용하세요.
{% endhint %}

## 속성 값 입력 <a href="#add-attributes-data" id="add-attributes-data"></a>

속성을 추가한 후 **제품 등록 과정에서 각 속성 값을 입력**할 수 있습니다. 예를 들어 ‘컬러’ 속성을 추가했다면, 제품별로 ‘빨강’, ‘검정’과 같은 값을 입력합니다.

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/0eb6dc0b1eba4d18bbe4b03ef437f6c9/iframe?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/0eb6dc0b1eba4d18bbe4b03ef437f6c9/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}

{% hint style="success" %}
자동 완성 목록에는 **기존에 입력된 값들이 자동으로 표시**됩니다. 별도로 목록을 직접 수정하거나 삭제할 수 없으며, 해당 값을 사용하는 제품에서 수정하거나 삭제하면 자동으로 반영됩니다.
{% endhint %}

## 묶어보기 <a href="#group-by" id="group-by"></a>

동일한 제품명이나 속성 값(카테고리, 브랜드 등)을 **그룹으로 묶어 확인**할 수 있는 기능입니다.

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/fc024d045a714bf9aceb0a37b048f246/iframe?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/fc024d045a714bf9aceb0a37b048f246/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}
PC - 속성 묶어보기
{% endembed %}

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/595b0e47b966459cb85a1f28a474a45d/iframe?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/595b0e47b966459cb85a1f28a474a45d/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}
Mobile - 속성 묶어보기
{% endembed %}

## 속성 변경 이력 확인 <a href="#attribute-change-history" id="attribute-change-history"></a>

속성 값의 변경 이력은 `제품 목록` > `제품 선택` > `…` > `속성 변경 이력`에서 확인할 수 있습니다.

<figure><img src="https://3639913499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnmQcxJVYbkAeUq7yQCkF%2Fuploads%2Fgit-blob-9f821c810ab4ba5b4af2ef45664b6b50c3cfa4c4%2Ffilename%20-%202025-09-10T112238.252.png?alt=media" alt="속성 변경 이력 확인하는 경로"><figcaption></figcaption></figure>

***

## <mark style="color:$info;">FAQ</mark> <a href="#faq" id="faq"></a>

### <mark style="color:$info;">삭제한 속성을 복구할 수 있나요?</mark> <a href="#id-1" id="id-1"></a>

[<mark style="color:$info;">**고객센터**</mark>](https://www.boxhero.io/docs/documentation/ko/contact)<mark style="color:$info;">로 삭제된 속성명을 알려주시면 복구해 드립니다.</mark>

### <mark style="color:$info;">속성은 몇 개까지 추가할 수 있나요?</mark> <a href="#id-2" id="id-2"></a>

<mark style="color:$info;">개수 제한 없이 자유롭게 추가할 수 있습니다.</mark>

### <mark style="color:$info;">속성 종류를 변경할 수 있나요?</mark> <a href="#id-3" id="id-3"></a>

<mark style="color:$info;">속성 종류를 변경할 수는 없습니다. 원하는 종류로 새 속성을 추가한 뒤,</mark> [<mark style="color:$info;">**엑셀 대량 수정**</mark>](https://www.boxhero.io/docs/documentation/ko/items#make-changes-to-multiple-items)<mark style="color:$info;">을 통해 기존 속성에 입력된 데이터를 새 속성으로 등록해 주세요. 이후 기존 속성을 삭제하시면 됩니다.</mark>

### <mark style="color:$info;">속성을 변경하거나 삭제하면 히스토리에 어떻게 기록되나요?</mark> <a href="#d-4" id="d-4"></a>

<mark style="color:$info;">제품명, 속성, 가격 등 제품 정보를 수정하면 과거 입출고 내역에도 수정된 정보가 반영됩니다. 즉,</mark> <mark style="color:$info;">**`히스토리`**</mark><mark style="color:$info;">에 표시되는 제품 정보는</mark> <mark style="color:$info;">**항상**</mark> <mark style="color:$info;">**현재 등록된 제품 정보**</mark><mark style="color:$info;">를 기준으로 표시됩니다.</mark>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://www.boxhero.io/docs/documentation/ko/data-center/attributes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
