Company Properties are attributes attached to a company or group of users rather than to individual users. These "nested" properties describe characteristics that apply to multiple users within the same organization or account — things like subscription tier, company size, or renewal date.
Chameleon lets you send company-level properties alongside user data so you can target Experiences at the account level. This is especially useful for B2B products where you want to reach all users in a company based on shared characteristics.
👉 Read about understanding data in Chameleon for a full overview of the data types available to you.
How are Company Properties different from User Properties?
User Properties describe an individual: their email, role, plan, or sign_up_date.
Company Properties describe the account or organization that user belongs to; the company's name, industry, size, or renewal_date.
The key difference: a User Property is unique to one person, while a Company Property is shared by everyone at that company.
| User Properties | Company Properties |
Describes | An individual user | An account or organization |
Unique to | A single person | All users in the same company |
Examples |
|
|
Identified by | User ID ( | Company ID ( |
Best for | Personalizing content, role-based targeting | Account-level targeting, B2B segmentation |
ℹ️ Company Properties are attached to user profiles, so you can build audiences that combine both user-level and company-level data. For example, you can target "Product Managers at companies on the Enterprise plan."
What can I do with Company Properties?
Company Properties are particularly useful when you want to target multiple users based on shared characteristics, such as:
Users with the same subscription renewal date
Users from companies attending specific marketing events
Users from companies of a particular size or industry
All users in accounts approaching the end of a trial
Once you're sending company data to Chameleon, you can:
Segment by company attributes: Create account-based audiences using company-level filters. Combine them with User Properties for even more precise targeting.
View companies in your Dashboard: Visit Users → Companies in your Dashboard to see companies listed as individual records with their associated properties and user counts.
Target Experiences to account-level criteria: Deliver Experiences to all users at a specific company, or to specific roles within a set of companies.
How do I send Company Properties to Chameleon?
Via the JavaScript API
When calling chmln.identify(), include a company object nested inside the user properties. The company.uid field is required — it tells Chameleon which company this user belongs to.
chmln.identify(USER.ID_IN_DB, { // Unique ID of each user in your database, must be a string (e.g. "23443" or "590b80e5f433ea81b96c9bf6")
email: USER.EMAIL, // Put quotes around text strings (e.g. "jim@example.com")
company: { // For B2B products, send company / account information here
uid: COMPANY.ID_IN_DB, // Unique ID of the company / account in your database (e.g. 9832 or "590b80e5f433ea81b96c9bf7")
created: COMPANY.SIGN_UP_DATE, // To enable targeting all users based on this company property
name: COMPANY.NAME, // Send any data that appears within URLs, such as subdomains (e.g. "airbnb")
trial_ends: COMPANY.TRIAL_ENDS, // Send data about key milestones (e.g. "2017-08-01T03:21:10Z")
version: COMPANY.VERSION, // If your software varies by version then this will help show the correct guidance (e.g. "1.56")
plan: COMPANY.PLAN, // Send null when no value exists (e.g. "Gold", "Advanced")
...
spend: COMPANY.CLV // Send other properties that will help in targeting users (e.g. sales rep, source, stage)
},
});
💡 Send any properties that will help you target users at the account level: sales rep, source, lifecycle stage, ARR, or industry are all common choices.
Via Integrations
If you already use Twilio Segment or Freshpaint, then this is the best way to send data to Chameleon. You can enable both of these integrations from the Dashboard and Chameleon will automatically receive all the user data you already collect.
If you don't use these tools, but do use one of our data-source integrations (Amplitude, Mixpanel, Hubspot, Salesforce, etc.) you can pull data into Chameleon.
Via CSV imports
You can update Company Properties by uploading a CSV file from your Dashboard. Choose the "companies" option during the import flow and map your CSV columns to company properties in Chameleon.
👉 Read about how to import data with CSV files for step-by-step instructions on importing company data.
How do I view and manage Company Properties?
In the Data Management page
All Company Properties you send appear on the Data Management page under the Company Properties tab. Here you can review what data you're sending, rename properties, add descriptions, and archive anything that's no longer relevant.
In the Users page
Visit Users → Companies in your Dashboard to see all your companies listed as individual records.
Click on any company (or a company badge from a user profile) to open the company slideover, which shows all Company Properties synced to Chameleon and the list of users associated with that company.
You can filter by Company Properties, export lists, and create Segments starting from the account level.
👉 Read about browsing Users and Companies in Chameleon to learn how to navigate your company data.
What Company Properties should I send?
The Company ID (company.uid) is the only required field. Beyond that, we recommend sending properties that help you differentiate accounts and target the right guidance:
Property | Why it's useful |
| Display company names in the Dashboard and use for personalization |
| Target Experiences by account tier — upsell, onboarding, or plan-specific guidance |
| Know when the account was created to target based on tenure |
| Tailor Experiences to the complexity of the organization |
| Deliver industry-specific guidance or messaging |
| Target users around key account milestones |
| Prioritize high-value accounts for personalized guidance |
💡 Think about the account-level attributes your team uses to segment customers today! Those are likely the same properties you should send to Chameleon.