콘텐츠로 건너뛰기
주의:: 이 문서는 사용자의 편의를 위해 제공됩니다. 이 문서는 번역 소프트웨어를 사용하여 자동으로 번역되었으며 교정을 거치지 않았을 수 있습니다. 이 문서의 영어 버전이 가장 최신의 정보를 확인할 수 있는 공식 버전으로 간주해야 합니다. 여기에서 액세스할 수 있습니다..

HubSpot의 속성 필드 유형 이해하기

마지막 업데이트 날짜: 2026년 6월 12일

명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.

HubSpot에서 사용자 정의 속성을 생성할 때, 해당 속성이 수집하고 저장할 정보의 유형에 따라 선택할 필드 유형이 결정됩니다. 특정 필드 유형의 경우, 속성 생성 후에도 속성의 유형이나 옵션을 편집할 수 있습니다.

사용자 지정 솔루션 구축

기본 속성에 대한 자세한 내용은 속성 API를 참조하세요.

텍스트 입력

사용 가능한 텍스트 입력 속성은 다음과 같습니다:

  • 단일 행 텍스트: 단어, 구, 문장 등 영숫자 문자로 구성된 단일 문자열을 저장합니다. CRM을 통해 값을 추가할 경우 문자 제한은 65,536자입니다. 양식을 통해 값을 제출할 경우 제한이 없습니다.
  • 다중 행 텍스트: 단락이나 항목 목록과 같은 여러 개의 영숫자 문자열을 저장합니다. CRM을 통해 값을 추가할 경우 문자 제한은 65,536자입니다. 양식을 통해 값을 제출할 경우 제한이 없습니다.

참고: 다중 행 텍스트 속성 값에 포함된 줄 바꿈은 마케팅 이메일, 견적서, 시퀀스 등 특정 도구에서는 지원되지 않습니다. 계정에 Data Hub 구독이 있는 경우 줄 바꿈 추가를 자동화할 수 있습니다.

  • 전화번호: 전화번호를 저장합니다. 여기에는 기본 전화번호, 휴대전화 번호팩스 속성이 포함되지만, 사용자 지정 전화번호 속성을 생성할 수도 있습니다. 국가 코드를 기반으로 전화번호에 표준 서식 및 유효성 검사가 자동으로 적용됩니다.

옵션 선택

사용 가능한 선택 옵션 속성은 다음과 같습니다:

  • 단일 선택 상자: '켜기' 또는 '끄기' 두 가지 옵션만 저장합니다. 값이 참(true) 또는 거짓(false)인 속성이 필요한 경우 이 필드 유형을 사용할 수 있습니다. 양식에서는 단일 선택 상자로 표시됩니다.
  • 다중 선택 상자: 여러 옵션을 포함하는 선택 상자를 저장합니다. 이는 열거형 속성입니다. 열거형 속성의 기술적 제한 사항에 대해 자세히 알아보세요.

참고: 다중 체크박스 속성에서는 사용자 지정 정렬이 지원되지 않습니다.

  • 드롭다운 선택: 여러 옵션을저장하며 , 값으로 하나의 옵션만 선택할 수 있습니다. 양식에서는 라디오 선택 필드와 동일하게 작동하지만, 모양은 다릅니다. 이는 열거형 속성입니다. 열거형 속성의 기술적 제한 사항에 대해 자세히 알아보세요.
  • 라디오 선택: 여러 옵션을 저장하며, 값으로 하나의 옵션만 선택할 수 있습니다. 레코드 편집 시에는 드롭다운 선택 필드와 동일하게 표시되고 동작합니다. 양식에서는 드롭다운 선택 필드와 동일하게 동작하지만, 모양은 다릅니다. 이는 열거형 속성입니다. 열거형 속성의 기술적 제한 사항에 대해 자세히 알아보세요.

참고: 양식 (레거시)에서 날짜 및 시간 선택기 속성을 사용하는 경우, 날짜만 표시되며 CRM의 속성 값에는 입력 되지 않습니다. 업데이트된 양식 작성기를 사용하는 경우, 양식에 날짜 및 시간 속성을 추가할 수 없습니다. 이러한 이유로 양식에서는 대신 날짜 선택기 속성을 사용하는 것이 좋습니다.

열거형 속성(예: 드롭다운 선택, 다중 선택 상자, 라디오 버튼)의 경우 다음 기술적 제한 사항이 적용됩니다:

  • 각 옵션은 레이블, 값 및 설명을 포함하여 최대 3,000자까지 입력할 수 있습니다.
  • 속성의 최대 크기는 512,000바이트 또는 5,000개 옵션 중 먼저 도달하는 쪽입니다.

구독 필요 계산 필드 유형을 사용하려면 Professional 또는 Enterprise 구독이 필요합니다.

  • 숫자: 십진법 또는 과학적 표기법으로 작성된 숫자 문자열을 저장합니다 . 속성을 생성하거나 편집할 때 숫자 속성의 서식을 선택할 수 있습니다:
    • 서식 지정: 숫자에 쉼표를 사용하여 서식을 지정합니다 ( 예: 1,000,000). 서식이 지정된 숫자의 길이는 20자 이내여야 합니다. 20자를 초과하면 지수 표기법으로 표시됩니다.
    • 서식 없음: 숫자 서식을 제거합니다(예: 1000000). 서식이 없는 숫자는 문자열로 처리되므로, 서식이 없는 값은 자릿수가 매우 많을 수 있습니다. 그러나 보고서에서 최상의 결과를 얻으려면 값의 총 자릿수가 38자를 초과하지 않아야 하며, 이 중 소수점 오른쪽 자릿수는 10자 이내여야 합니다.
    • 백분율: 숫자를 백분율로 서식 지정합니다 (예: 90%). 백분율 속성 값은 소수점으로 저장됩니다(예: 75%는 .75로 저장됨).
    • 통화: 계정의 기본 통화 설정에 따라 숫자를 통화 형식으로 서식 지정합니다.

참고: 워크플로 및 세그먼트 등록 기준은 정수만 설정할 수 있지만, 레코드가 기준을 충족하는 경우 소수점이 포함된 값이라도 워크플로 또는 세그먼트에 등록될 수 있습니다. 예를 들어, 숫자 속성의 값이 -2.5인 연락처는 '숫자 속성이 -2보다 작음' 등록 트리거가 있는 워크플로에 등록됩니다.


  • 계산: 연관된 레코드의 속성 또는 사용자 정의 방정식의 속성을 기반으로 한 수식을 저장합니다. 계산 속성은 양식에서 사용할 수 없습니다.
  • 롤업: 값을 저장합니다. 롤업 유형에 따라 선택된 개체의 모든 레코드에 대한 속성 값을 계산합니다. 유형 옵션에는 최소, 최대, 개수, 합계평균이 포함됩니다. (예: 모든 관련 회사의 생성 날짜 개수). 서식 옵션에는 서식 지정, 서식 미지정, 통화, 백분율기간이 포함됩니다. 예를 들어, 생성 날짜를 기준으로 모든 관련 회사의 개수를 확인하는 롤업 속성을 만들 수 있습니다.

기타

구독 필요 속성 동기화 필드 유형을 사용하려면 Professional 또는 Enterprise 구독이 필요합니다.

  • 속성 동기화: 연결된 레코드의 속성에서 동기화된 값을 저장합니다. 연결된 레코드의 선택된 속성이 설정되거나 변경되면 동기화 속성의 값이 자동으로 업데이트됩니다. 동기화 속성을 설정하는 방법을 알아보세요.
  • 파일: 레코드와 관련된 파일을 저장합니다. 사용자는 레코드를 생성하거나 편집할 때 파일을 업로드할 수 있습니다. 방문자는 양식 제출을 통해 파일을 업로드할 수 있습니다. 각 파일 속성에는 최대 10개의 파일을 포함할 수 있습니다. 레코드의 파일 업로드 제한은 무료 도구 계정의 경우 20MB, 유료 구독 계정의 경우 50MB입니다. 양식 제출을 통해 업로드되는 경우 각 파일의 크기는 100MB로 제한되며, 파일 링크는 제출자의 연락처 레코드에서 확인할 수 있습니다. 파일 속성을 생성할 때 해당 속성에 업로드된 파일을 볼 수 있는 사용자를 선택할 수 있습니다. HubSpot에서 지원하는 파일 형식에 대해 자세히 알아보세요.
  • HubSpot 사용자: HubSpot 계정의 사용자 목록을 저장합니다. 한 명 또는 여러 명의 HubSpot 사용자를 선택할 수 있습니다. 이 필드 유형은 기본 [Object] 소유자 속성과 별도로 사용자 정의 소유자 속성을 생성하는 데 사용할 수 있습니다. 이 속성에 선택된 사용자는 레코드 소유자로 간주되며, 소유자와 동일한 레코드 편집 권한을 갖게 됩니다. 예를 들어, 레코드와 관련하여 추가 사용자의 역할을 지정하기 위해 "담당자" 또는 "협력자" 속성을 생성할 수 있습니다. 최대 50개의 사용자 정의 HubSpot 사용자 속성을 생성할 수 있습니다. 사용자 속성은 양식에서 사용할 수 없습니다. 레코드 소유권 할당레코드에 대한 사용자 권한에 대해 자세히 알아보세요.
  • URL: 올바른 형식의 URL 링크(예: https://www.yourdomain.com)를 저장합니다. 허용하거나 차단할 도메인 목록을 지정할 수 있습니다. 값을 입력하면 https://가 자동으로 앞부분에 추가됩니다. 유효한 URL 형식에 맞지 않는 값은 저장할 수 없습니다. URL 속성 값은 CRM 내에서 클릭 가능한 링크로 작동합니다(예: 인덱스 페이지에 표시될 때). URL 속성은 양식에서 사용할 수 없습니다.
  • 서식 있는 텍스트: 서식이 지정된 텍스트와 이미지를 저장합니다. 서식 옵션에는 굵게, 기울임꼴, 밑줄, 텍스트 색상, 글꼴 종류 및 크기, 번호 매기기 및 글머리 기호 목록, 단락 들여쓰기, 하이퍼링크 및 이미지가 포함됩니다. 기본적으로 서식 있는 텍스트 데이터는 단락으로 렌더링되므로, 서식 있는 텍스트 속성 값은 인라인 텍스트가 아닌 콘텐츠 내의 별도 단락으로 사용하는 것이 가장 좋습니다. 이미지를 삽입할 때 최대 크기는 픽셀 수보다는 이미지의 데이터 양에 따라 결정됩니다. 이미지를 포함하여 속성 값의 최대 크기는 64KB입니다. 서식 있는 텍스트 속성은 양식에서 사용할 수 없습니다.
  • 이메일: 올바른 형식의 이메일 주소(예: example@hubspot.com)를 저장합니다. 허용되는 도메인을 지정할 수 있습니다: 모든 도메인, 특정 도메인만 허용, 또는 특정 도메인 차단. 값을 입력할 때는 오류를 방지하기 위해 @ 기호와 허용된 도메인을 추가해야 합니다. 마케팅 이메일이나 일대일 이메일을 보낼 때 수신자 필드로 사용자 지정 이메일 속성을 사용할 수 없습니다.
이 문서가 도움이 되었나요?
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.