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)를 저장합니다. 허용되는 도메인을 지정할 수 있습니다: 모든 도메인, 특정 도메인만 허용, 또는 특정 도메인 차단. 값을 입력할 때는 오류를 방지하기 위해
@기호와 허용된 도메인을 추가해야 합니다. 마케팅 이메일이나 일대일 이메일을 보낼 때 수신자 필드로 사용자 지정 이메일 속성을 사용할 수 없습니다.