> ## Documentation Index
> Fetch the complete documentation index at: https://docs.push.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Product Updates

> New updates and improvements.

<Update label="2026-03-09" description="v0.14.2">
  ### New Feature: AI-Assisted Model Editing

  * The AI agent can now suggest changes to your semantic models — adding metrics, measures, and dimensions with inline patch suggestions
  * Live activity timeline shows each step the agent takes when building or updating a model
  * Modified rows are highlighted so you can quickly review what changed before accepting suggestions
  * Smarter validation catches issues like duplicate measure names and invalid metric configurations before they're saved

  ### New Feature: Learning Center

  * Interactive learning modules covering key concepts: data modeling, knowledge graphs, integrations, context windows, agent skills, and more
  * Each module walks through a topic in digestible sections with clear explanations
  * Mobile-friendly layout with responsive navigation

  ### Charts & Visualizations

  * New waterfall chart type with dynamic formatting and percentage support
  * Time series analysis charts now lock their chart type to prevent accidental changes
  * Fixed-schema chart types hide irrelevant configuration controls for a cleaner editing experience

  ### Context & Integrations

  * New Context overview page showing a unified summary of all connected sources — data warehouses, integrations, knowledge, and web sources
  * Redesigned context sidebar with per-card scrolling and clearer organization
  * Agent responses now link back to the specific integration sources they used, so you can see where each answer came from
  * Data table previews load faster with pre-fetched source details

  ### Semantic Layer & Models

  * Top-level metric filters let you scope any metric to a specific subset of data directly from the metric configuration modal
  * Percentile aggregation support for measures
  * Derived metrics now support per-reference filters on formula tokens for more precise calculations
  * Cascading validation: deleting or modifying a model element now correctly flags all dependent metrics and dimensions
  * Models can be created without measures for dimension-only use cases

  ### AI Agent Improvements

  * Agent now tracks and displays web page sources used during analysis
  * Improved search with pagination and per-type result counts for more complete answers
  * Better handling of complex metric references and object mentions in conversation

  ### Onboarding

  * Onboarding now includes a real query step so you can test your data connection immediately after setup
  * Data source auto-detection streamlines the warehouse connection flow

  ### Settings & UX

  * Column type icons are now consistently aligned across all data tables
  * Full internationalization pass across the product with improved translations
  * Fixed a settings panel flash when closing modals

  ### Performance & Reliability

  * Faster permission checks with cached authorization policies
  * Fixed streaming timeouts that could interrupt long-running agent sessions
  * Fixed issues with model creation forms silently dropping invalid configurations
  * Resolved errors when editing conversion metrics and derived metric references
  * Fixed query planner errors when referencing removed semantic objects
</Update>

<Update label="2026-02-16" description="v0.14.1">
  ### New Onboarding Experience

  * Interactive product demo that walks through Push AI's capabilities in under 5 minutes — no setup required
  * Progressive demo starting with a basic data answer, then layering on web research and integrations to show the full power of multi-source AI
  * Streamlined flow to connect your data warehouse (Snowflake, BigQuery, Redshift, ClickHouse, Databricks) with connection testing and field grouping
  * After connecting tools like Slack, Notion, and GitHub via OAuth, onboarding shows what was discovered (channels, repos, pages) in a scrollable carousel
  * Clear 5-step progress indicator (Demo, Connect, Explore, Model, Integrate) keeps you oriented throughout setup

  ### Redesigned Home Dashboard

  * Completely redesigned landing experience with a query input overlay and live metric ticker bar with inline sparkline charts
  * Click any metric in the ticker to see a full-width trend chart powered by real data from your warehouse
  * See your active agents and recent activity at a glance from the home page

  ### Metric Formatting

  * Configure how each metric displays its values — choose number, currency, or percentage with decimal precision, compact notation (1.2K, 3.4M), and custom currency symbols
  * Formatting settings now apply consistently across charts (axes, tooltips, value labels), data tables, and CSV/JSON exports
  * Set format and goal direction directly from the metric settings modal
  * Update format and goal direction for multiple metrics at once

  ### Unified Data Display

  * Every data result now has a single toggle to switch between table view, chart view, and the underlying SQL
  * Smooth cross-fade animations when switching between table, chart, and code views
  * Toggle text wrapping in data table cells for better readability of long values
  * Tables with many columns now handle gracefully, preventing issues with wide datasets

  ### Charts in Notifications

  * When an agent sends a scheduled report, charts are now rendered as images and included inline in Slack, Teams, and Email
  * Data table results sent to Slack now include a downloadable CSV file attached to the message

  ### AI Agent Improvements

  * Live-updating todo list in the context sidebar as the agent works through complex analyses — see what's pending, in progress, and completed
  * Agents can now execute longer analysis runs for deeper, more thorough results
  * Upgraded report writing for more coherent and complete output
  * Data queries no longer cap at 100 rows — the agent retrieves all the data it needs for accurate analysis
  * Improved chart generation with more reliable field detection for visualizations

  ### Semantic Layer & Validation

  * New issues page showing all invalid objects with error details and one-click resolution paths
  * When a dimension, entity, or time field becomes invalid, all metrics that reference it are now automatically flagged
  * Models with dimensions but no metrics are now fully supported
  * Faster validation on large semantic layers

  ### Data Model & Connections

  * Redesigned business graph with a hub-and-spoke layout and dedicated panels for Sources, Metrics, Relationships, and Knowledge
  * Consolidated warehouse connection forms into a single consistent experience across all providers

  ### Task Progress

  * Integration discovery and metadata sync now report detailed progress (which schemas, tables, and columns are being processed) instead of just showing "pending"

  ### Performance & Reliability

  * Fixed several issues that could freeze the query page or prevent navigation
  * Fixed rendering issues with wide data tables containing many columns
  * Fixed chart rendering issues in scheduled Slack and Email reports
</Update>

<Update label="2026-02-09" description="v0.14.0">
  ### Charts & Visualizations

  * New chart types: treemap, heatmap, pie, and donut charts with percentage labels and smart aggregation
  * Interactive charts: click to select data points, legend filtering, and reference lines/bands for annotations
  * Smart date axes with continuous temporal scale and automatic quarter label formatting
  * Small multiples: break a chart into a grid of subcharts by any dimension for easy comparison
  * Download charts as images directly from the chat interface
  * Simplified, cleaner tooltip design for source citations

  ### Data Tables

  * Completely rebuilt data tables with column sorting, drag-to-reorder columns, and column resizing
  * Tables with hundreds of rows now render instantly
  * Global search across all columns with instant highlighting and filtered row counts
  * Row grouping and aggregation: group rows by any dimension with collapsible sections and automatic numeric aggregation
  * One-click copy to clipboard, or export as CSV / JSON — respects any active search filters or row selection
  * Conditional formatting: toggle heatmap-style color coding for numeric columns to spot patterns at a glance
  * Sticky headers and optional row numbering

  ### Query & Chat Experience

  * New context sidebar showing all data sources and integrations referenced in your conversation
  * Click any data source in the context sidebar to open a resizable live data preview alongside your chat
  * Scroll-to-bottom button to quickly jump to the latest message in long conversations
  * Metrics built from other metrics (derived/composite) are now fully supported in queries
  * View the generated SQL behind any metric or query result

  ### Integrations

  * Connect third-party tools directly from settings with a streamlined OAuth experience
  * Name your connections, view details, and delete with inline confirmation
  * Push AI now automatically discovers your Slack channels, GitHub repos, Linear projects, Notion pages, and Asana workspaces so the AI can reference them in context
  * Improved search and navigation in the integrations settings panel

  ### Semantic Layer & Models

  * Create and edit semantic models using a rich YAML editor with inline validation and error messages with line numbers
  * View and manage derived/composite metrics that reference other metrics
  * More reliable syncing between your data warehouse schema and your semantic model definitions

  ### AI Agent

  * 11 new built-in analysis skills including trend analysis, cohort comparison, anomaly detection, and more
  * Human-in-the-loop tool approval — the agent asks for your approval before executing sensitive actions
  * Hybrid query mode: the agent can now fall back to direct SQL when the semantic layer doesn't cover a question
  * Agent actions collapsed by default with clear one-line summaries; expand for full detail

  ### Settings & UX

  * Redesigned modal-based settings with faster loading and cleaner navigation
  * Two-panel dashboard layout with improved schema browsing on the data page
  * Better UX for finding and managing saved queries
  * Cleaner agent history grouped by query instead of individual runs
  * Streamlined product experience with fewer options for a more focused workflow

  ### Performance

  * Faster data transfer with an optimized data pipeline
  * Query results, entity recognition, and join resolution now cached with automatic invalidation on model changes
  * Fixed inflated query view counts — now tracks unique viewers per query
  * Faster page loads through reduced bundle size
</Update>

<Update label="2026-01-31" description="v0.13.0">
  ### New Feature: Multi-Model Queries

  * Query data across multiple semantic models in a single request
  * Smart disambiguation when objects exist in multiple models
  * Automatic discovery of join paths between models

  ### Complex Metrics

  * Create derived metrics based on other metrics
  * Use metrics in filter conditions
  * Support for queries without aggregation

  ### Model Validation

  * See exactly why a model or object is invalid
  * Automatic scheduled validation of models

  ### YAML Model Creation

  * Create semantic models using YAML syntax with a built-in code editor
  * Real-time validation with helpful error messages
  * Automatic label generation from definitions

  ### New Feature: Tool Approval

  * Review and approve tool executions before they run
  * Clear visual feedback on approval status
  * Dedicated approval flow for SQL execution

  ### New Feature: AI Skills

  * New skills system for higher-level agent orchestration
  * 11 new analysis skills available out of the box
  * Create custom skills for your team

  ### Hybrid Query Mode

  * Automatically fall back to SQL when the semantic layer can't answer a question
  * Combine semantic layer precision with SQL flexibility

  ### Time Field Improvements

  * Models can specify default time fields
  * Better handling of time grain throughout queries

  ### Performance

  * Faster query compilation and execution
</Update>

<Update label="2025-12-31" description="v0.12.0">
  ### New Feature: Subagents

  * Main agent can now coordinate specialized subagents for complex analysis
  * Parallel subagent execution with result aggregation
  * View results from subagent runs in the main conversation
  * Control how many subagents run simultaneously

  ### New Feature: Agent Scheduling

  * Set up agents to run on a recurring schedule
  * Configure scheduling behavior with flexible policies
  * Track whether a run was triggered manually or by schedule

  ### Agent Configuration

  * Configure reasoning effort for more thorough or faster analysis
  * Control the level of detail in agent responses
  * Choose which AI model powers each agent

  ### Data Table Improvements

  * Better axis configuration for data visualizations
  * Richer metadata for table columns
  * Improved dimension value handling

  ### Knowledge Documents

  * Documents now influence query mode selection
  * Documents included in AI context based on query mode
</Update>

<Update label="2025-11-28" description="v0.11.0">
  ### New Feature: SQL Explore Mode

  * New query mode for direct SQL exploration of your data
  * Choose between Explore, Analyze, and Deep Research modes
  * Select specific data sources for exploration
  * Configure which schemas, tables, and columns are available

  ### Data Source Objects

  * Reference schemas, tables, and columns in queries using @mentions
  * Data source objects now appear in the business graph
  * Detailed tooltips for database objects on hover

  ### AI-Powered Metadata

  * AI-suggested descriptions and synonyms for objects
  * Edit metadata directly in tables
  * Refresh schema with automatic column reconciliation

  ### Knowledge Documents

  * Link knowledge documents to metrics, dimensions, and other objects
  * Documents can influence which query mode is used
  * Full lifecycle management: publish, unpublish, and delete

  ### Agent History

  * View parameter values used in agent runs
  * See who created each agent run

  ### Search Improvements

  * Improved search including descriptions and synonyms
  * Option to search by name only for precise matching
  * Show complete object paths in selector

  ### Integrations

  * Updated authentication for improved compatibility with third-party providers
</Update>

<Update label="2025-10-31" description="v0.10.0">
  ### New Feature: Knowledge Documents

  * Full-featured document editor with versioning and autosave
  * Save drafts and publish when ready
  * View and restore previous versions of documents
  * Compare changes between document versions

  ### Navigation Reorganization

  * "Knowledge" is now "Context" for clearer navigation
  * New dedicated Integrations tab under Context

  ### New Feature: Business Graph 2.0

  * Completely rewritten visualization with an interactive canvas
  * Automatic graph layout with smart positioning
  * Web pages and knowledge documents now appear in the graph
  * Rich tooltips on graph nodes showing object details
  * Navigate the graph by expanding and collapsing nodes

  ### Agent Improvements

  * Agents can now have parameterized dimension values
  * New card UI with metric charts showing goal progress
  * View agent run history with status and timing
  * Dedicated tabs for monitoring agent status

  ### New Data Source: ClickHouse

  * Connect to ClickHouse databases
  * Full schema discovery for ClickHouse with proper case-sensitivity handling

  ### Integration Objects

  * Select which Slack channels and users to include
  * New UI for selecting integration objects

  ### New Feature: Report Builder

  * Add data queries directly to reports
  * Use relative time periods instead of fixed dates
  * Include agent analysis in reports
</Update>

<Update label="2025-09-30" description="v0.9.0">
  ### New Feature: Agent Configuration

  * New rich text editor for configuring agent prompts
  * Reference integrations, metrics, and other objects directly in agent prompts using @mentions
  * Configure goal metrics for agents to track

  ### Object Mentions

  * Rich tooltips showing object details on hover
  * Integrations can now be mentioned like other objects in prompts

  ### New Feature: Metric Formulas

  * New UI for creating and editing metric formulas
  * Automatic measure extraction from data queries
  * Visual indicators when objects aren't valid for use in formulas

  ### Field Mapping

  * Redesigned field mapping step in model creation
  * Progressive field mapping during model setup

  ### Query Experience

  * Share queries at specific timestamps
  * Check for model references in queries
</Update>

<Update label="2025-08-29" description="v0.8.0">
  ### New Chart Types

  * Waterfall charts for visualizing incremental changes over time
  * Area and scatter chart options
  * Improved axis formatting with smarter date and time labels

  ### New Feature: Query Sharing

  * Share queries with team members via a new sharing modal
  * Generate public links to share query results externally
  * View and edit permissions now enforced on shared queries

  ### Model Management

  * Improved model editing experience with better field management
  * Bulk operations for business objects
  * Merge duplicate or related business objects
  * Track and display active and inactive fields

  ### Metrics & Measures

  * Improved interfaces for managing measures including SQL preview
  * Better metric type selection and configuration
  * Support for distinct count and other aggregate functions
  * Improved time field handling in models
</Update>

<Update label="2025-07-31" description="v0.7.2">
  ### Query Experience Overhaul

  * Redesigned query creation flow with a cleaner, more intuitive interface
  * New query grid layout for browsing and managing saved queries
  * More responsive query cancellation

  ### Data Exploration

  * Explore dimension values directly within the query interface
  * Real-time "Analyzing..." feedback while the AI processes your question

  ### Integrations

  * Integrations now seamlessly connect to the AI assistant
  * Better visibility into agent task execution status

  ### Permissions

  * New permission scoping for better access control
  * Fixed interaction issues with permission-gated elements

  ### Internationalization

  * Added support for Spanish and French locales
</Update>

<Update label="2025-07-28" description="v0.7.1">
  ### New Feature: Slack as a Source of Context in Reviews

  * The agent uses what your team is already discussing in the channel to improve relevancy and respond to feedback.
  * This gives the agent context around what's important and a method of providing feedback
  * Use this to facilitate an asynchronous weekly business review style workflows

  ### Agent Updates

  * Latency improvements through faster tool initialization with integrations
  * Thread management in Slack across both channels and app DMs
</Update>

<Update label="2025-07-14" description="v0.7.0">
  ### Agent Updates

  * Latency improvements through LLM model caching
  * Enhanced charting configuration
  * Enhanced search capabilities for faster and more relevant results

  ### New Feature: Record-level Data Queries

  * Support for record-level queries to drill into data further
  * Define Attributes for longer context or high cardinality fields (Beta)
</Update>

<Update label="2025-06-01" description="v0.6.2">
  ### New Feature: Tools

  * Tools allow you to leverage context from and take action in your third-party applications
  * Tool integrations include Gmail, Hubspot, Google Calendar, Linear, Notion and 250+ additional integrations.
  * Over time, we'll work to more deeply integrate and connect the objects and resources from these integrations into the Business Graph (e.g., connect a message, meeting transcript, or document to a single, canonical customer record)
</Update>

<Update label="2025-05-15" description="v0.6.1">
  ### Agent Updates

  * Query Agent: Improved Slack search performance and latency
  * Query Agent can now answer questions using Push.ai documentation
  * Added support for web tools, enabling real-time web and documentation search

  ### New Feature: Use the Query Agent in Slack and Microsoft Teams

  * Query the Agent directly in Slack channels, App DMs, and Microsoft Teams
  * Agent responses in Reviews now include deeper background analysis, chart generation, and custom destination formats
</Update>

<Update label="2025-04-28" description="v0.6.0">
  ### New Feature: The Push.ai Query Agent

  * Ask questions in natural language using trusted semantic-layer queries
  * Agentic Business Graph exploration (i.e., it can do data analysis for you)
  * Brings explicity tagged and relevant untagged Business Objects into context
  * Support for citations, sources, charts, tables
</Update>

<Update label="2025-03-25" description="v0.5.23">
  ### General Updates

  * Added support for dimensions with derived metrics
</Update>

<Update label="2025-02-27" description="v0.5.22">
  ### New Feature: Knowledge

  * Support for generic knowledge processors of chat systems, meeting recording transcripts, and documents
  * Source specific and LLM-driven chunking
  * Added ability to integrate knowledge via data warehouses
  * Added ability to upload knowledge from files
</Update>

<Update label="2024-12-20" description="v0.5.21">
  ### General Updates

  * Enhanced performance and latency of the dbt semantic layer integration
</Update>

<Update label="2024-12-12" description="v0.5.20">
  ### General Updates

  * Introduced additional calculations for trailing periods and introduced calculations for future periods including "Next Period" and "Leading Periods"
  * Introduced Spanish translation support

  ### Bug Fixes

  * Fixed issue where calculation order was lost in Reviews
  * Fixed issue with displaying duplicate Dimensions in the Dimension table on metric pages
</Update>

<Update label="2024-12-06" description="v0.5.2">
  ### New Feature: Outliers (experimental)

  * Introduced ability for users to receive outliers for any metrics they've
    subscribed to
  * Introduced sensitivity configuration for outlier detection
</Update>

<Update label="2024-11-26" description="v0.5.1">
  ### Performance Improvements

  * Improved caching and performance of object selectors and omni-search
  * Introduced unlimited scroll for dimension-values, improving app performance with high cardinality dimension values

  ### UI Upgrades

  * Expanded use of iconography for metrics, dimension and dimension-values

  ### Bug Fixes

  * Fixed issues with Review creation and saving
  * Fixed ability to group-by dimensions and filter to dimension values
</Update>
