Document user_profiles_mv and user_labels tables

[yosriady]

Summary

Added documentation for two new project-scoped data tables: user_profiles_mv (first-party user profile traits from identify events) and user_labels (custom labels and tags assigned to wallet addresses). Updated the aggregate tables reference to include user_profiles_mv and document the argMaxIfMerge function pattern.

Changes

• Added user_profiles_mv table documentation with full column reference, use cases, and example query showing proper aggregate table usage with -Merge functions
• Added user_labels table documentation with column definitions and use cases for custom segmentation and scoring
• Updated aggregate tables section to include user_profiles_mv in the list of tables using ClickHouse AggregateFunction types
• Added argMaxIfMerge pattern to the aggregate function reference table to document the conditional max aggregation function

Implementation details

• user_profiles_mv is documented as an AggregatingMergeTree with a warning to use -Merge functions and GROUP BY address
• user_labels is positioned as the project-specific counterpart to the global wallet_profiles_labels table
• Both tables are placed in logical positions within the catalog (user_profiles_mv before wallet_profiles_mv, user_labels after wallet_profiles_labels)

https://claude.ai/code/session_01XeF9u7YLwBCXtsADz9esGH

---

^{Need help on this PR? Tag /codesmith with what you need. Autofix is disabled.}

[gemini-code-assist]

Code Review

This pull request adds documentation for the new user_profiles_mv and user_labels tables in data/catalog.mdx, and updates the aggregate tables section. The reviewer noted that documenting the columns of the aggregate table user_profiles_mv with simple types like String and DateTime is misleading and inconsistent. They suggested updating the table format to explicitly specify the ClickHouse AggregateFunction types and query functions.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[gemini-code-assist]

Since user_profiles_mv is an aggregate table (AggregatingMergeTree), documenting the columns with simple types like String and DateTime is inconsistent with the rest of the catalog (e.g., the users and wallet_profiles_mv tables). It is also misleading to users, as querying these columns directly will return binary aggregate states instead of readable values.

Updating the table to use the Query Function format and specifying the actual ClickHouse AggregateFunction types will make it clear how to query these fields.

| Column | Type | Query Function |
|--------|------|---------------|
| `address` | String | Direct access |
| `user_id` | AggregateFunction(argMaxIf, String, DateTime, UInt8) | `argMaxIfMerge(user_id)` |
| `display_name` | AggregateFunction(argMaxIf, String, DateTime, UInt8) | `argMaxIfMerge(display_name)` |
| `email` | AggregateFunction(argMaxIf, String, DateTime, UInt8) | `argMaxIfMerge(email)` |
| `farcaster`, `discord`, `twitter`, `telegram`, `instagram`, `github`, `linkedin`, `facebook`, `tiktok`, `youtube`, `reddit` | AggregateFunction(argMaxIf, String, DateTime, UInt8) | `argMaxIfMerge(column_name)` |
| `website` | AggregateFunction(argMaxIf, String, DateTime, UInt8) | `argMaxIfMerge(website)` |
| `ens`, `lens`, `basenames`, `linea` | AggregateFunction(argMaxIf, String, DateTime, UInt8) | `argMaxIfMerge(column_name)` |
| `avatar` | AggregateFunction(argMaxIf, String, DateTime, UInt8) | `argMaxIfMerge(avatar)` |
| `description` | AggregateFunction(argMaxIf, String, DateTime, UInt8) | `argMaxIfMerge(description)` |
| `location` | AggregateFunction(argMaxIf, String, DateTime, UInt8) | `argMaxIfMerge(location)` |
| `updated_at` | SimpleAggregateFunction(max, DateTime) | `max(updated_at)` |

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
formo	🔴 Failed	–	Jun 23, 2026, 6:19 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.