What You’ll Learn

This guide walks you through building SQL-based reports and dashboards in Mode Analytics. You’ll connect databases, write queries, create visualizations, and collaborate with your team on data analysis.

Time required: 45-60 minutes
Skill level: Intermediate to Advanced (SQL knowledge required)
What you need: Mode account (free trial or paid), access to a database (PostgreSQL, Redshift, Snowflake, BigQuery, etc.)


Step 1: Set Up Your Mode Account

Mode is a cloud-based analytics platform designed for data analysts and SQL users.

Getting started:
1. Sign up at mode.com
2. Choose plan tier:
– Mode Studio: Free (limited features, great for learning)
– Mode Business: $50-100/user/month
– Mode Enterprise: Custom pricing
3. Log in to Mode workspace

You’ll land on the Home screen showing recent reports.


Step 2: Connect Your Database

Mode works by running SQL queries directly against your database.

Add a data source:

  1. Click your workspace name (top-left) → Settings
  2. Go to Data Sources
  3. Click + New Connection
  4. Select database type:
  5. PostgreSQL, MySQL, Redshift, Snowflake, BigQuery, Databricks, etc.
  6. Enter connection details:
  7. Host/endpoint
  8. Port
  9. Database name
  10. Username and password (read-only credentials recommended)
  11. Test connection → Save

Security: Mode connects read-only by default. Never use admin credentials.


Step 3: Create Your First Report

In Mode, a report is a collection of SQL queries and visualizations.

Start a new report:

  1. Click + New (top-right) → Report
  2. You’re now in the Report Editor — Mode’s primary workspace

Report Editor sections:
– Notebook (left): Write SQL queries and Python/R code
– Schema Browser (right): Browse database tables and columns
– Visualizations (bottom): Create charts from query results


Step 4: Write Your First SQL Query

Mode is SQL-first — you must write queries to retrieve data.

Basic query:

  1. In the Query Editor (notebook section), type:
SELECT 
  product_name,
  SUM(revenue) as total_revenue
FROM sales
WHERE order_date >= '2026-01-01'
GROUP BY product_name
ORDER BY total_revenue DESC
LIMIT 10;
  1. Click Run (or Cmd/Ctrl + Enter)
  2. Results appear in the Results pane below

Query tips:
– Use the Schema Browser to explore tables and columns
– Click a table → Mode shows column names and types
– Drag column names into your query to auto-insert


Step 5: Create a Visualization from Query Results

Once you have query results, you can visualize them.

Create a bar chart:

  1. After running your query, click + Chart (bottom of results)
  2. Mode opens the Chart Builder
  3. Choose chart type: Bar chart
  4. Configure:
  5. X-axis: Select your dimension column (product_name)
  6. Y-axis: Select your metric column (total_revenue)
  7. Chart renders instantly

Chart types available:
– Bar, column, line, area, scatter, pie, table, pivot table, funnel, cohort, and more

Customization:
– Chart settings: Click Settings (gear icon) to adjust colors, labels, axes
– Filters: Add filters to let viewers explore data
– Formatting: Number formats, date formats, axis titles


Step 6: Add Multiple Queries to Your Report

Mode reports can contain multiple queries — useful for different views of your data.

Add a second query:

  1. Click + Query in the notebook
  2. Write a new SQL query (e.g., revenue trend over time):
SELECT 
  DATE_TRUNC('month', order_date) as month,
  SUM(revenue) as monthly_revenue
FROM sales
WHERE order_date >= '2025-01-01'
GROUP BY month
ORDER BY month;
  1. Run the query
  2. + Chart → choose Line chart for the trend

Each query in your report can have multiple visualizations.


Step 7: Use Parameters for Interactive Reports

Parameters let viewers change query values without editing SQL.

Add a parameter:

  1. In your SQL query, replace a hardcoded value with {{ parameter_name }}:
SELECT 
  product_name,
  SUM(revenue) as total_revenue
FROM sales
WHERE order_date >= '{{ start_date }}'
GROUP BY product_name
ORDER BY total_revenue DESC;
  1. Click Run
  2. Mode prompts you to enter a value for start_date
  3. Enter a date (e.g., 2026-01-01) → Run

Parameter types:
– Text: Free-form input
– Dropdown: Predefined list of values
– Date: Date picker

Viewers can now adjust parameters to explore different date ranges, products, regions, etc.


Step 8: Add Python/R Analysis (Advanced)

Mode supports Python and R for advanced analytics alongside SQL.

Add a Python notebook:

  1. Click + Python Notebook in your report
  2. Access SQL query results as DataFrames:
# datasets[0] = results from first query
df = datasets[0]

# Perform analysis
import pandas as pd
monthly_avg = df.groupby('month')['revenue'].mean()
print(monthly_avg)
  1. Run the Python code
  2. Create visualizations using matplotlib or plotly

Use cases:
– Statistical analysis (regression, forecasting)
– Machine learning models
– Custom visualizations
– Data transformations too complex for SQL


Step 9: Build a Dashboard

Mode dashboards display multiple visualizations in a clean layout.

Create a dashboard view:

  1. Click View Report (top-right) to exit edit mode
  2. Click Edit → Add to Dashboard (for each chart you want)
  3. Drag charts to position them
  4. Resize charts by dragging corners

Dashboard features:
– Filters: Add report-level filters (parameters apply across all queries)
– Text blocks: Add titles, descriptions, insights
– Layout: Customize spacing and arrangement


Step 10: Share Your Report

Share with team members:

  1. Click Share (top-right)
  2. Add people: Enter emails or select user groups
  3. Set permissions:
  4. Viewer: Can see the report and run queries
  5. Editor: Can modify SQL and visualizations
  6. Admin: Full control
  7. Click Share

Schedule email delivery:

  1. Click Report Actions (three dots) → Schedule Report
  2. Choose frequency: Daily, weekly, monthly
  3. Select recipients
  4. Choose format: PDF, CSV, or link
  5. Save schedule

Mode sends report snapshots automatically.

Embed in website or app:

  1. Report Actions → Embed
  2. Copy the embed code (iframe)
  3. Paste into your website HTML

Note: Embedding requires Mode Business or Enterprise plan.


Step 11: Collaborate on Reports

Mode is built for analyst collaboration.

Comment on reports:

  1. Click Comments (speech bubble icon)
  2. + New Comment
  3. @mention teammates to notify them
  4. Comments appear in the sidebar

Use cases:
– Ask questions about data
– Request changes to queries
– Discuss insights

Version control:

  • Mode auto-saves report versions
  • Click History (clock icon) to see previous versions
  • Restore any version with one click

Fork a report (create your own copy):

  1. Open someone else’s report
  2. Click Report Actions → Fork
  3. Edit the copy without affecting the original

Step 12: Organize Reports into Collections

Collections help teams organize reports by topic, team, or project.

Create a collection:

  1. Click Home → + New Collection
  2. Name your collection (e.g., “Sales Analytics”, “Marketing KPIs”)
  3. Add reports: Drag reports into the collection

Permissions: Set who can view or edit the collection.


Common Issues and Fixes

Query timeout errors:
– Optimize your SQL: Add WHERE clauses to reduce rows scanned
– Index slow columns in your database
– Contact Mode support to increase timeout limits (Enterprise plan)

Can’t connect to database:
– Check firewall rules: Whitelist Mode’s IP addresses (provided in Mode docs)
– Verify credentials and database permissions
– Test connection in database client first (pgAdmin, MySQL Workbench)

Visualizations not updating:
– Re-run the query: Mode caches results
– Check if database data has actually changed

Slow report loading:
– Reduce query complexity: Aggregate at the database level
– Use indexed columns in WHERE clauses
– Consider creating pre-aggregated views in your database


## ⚡ FASTER ALTERNATIVE: Skip Writing SQL Queries

**Mode is powerful for SQL-savvy analysts, but it requires writing queries for every insight.** If your team needs answers fast without writing SQL, consider an AI-first approach.

**[Pulse AI](https://usepulseai.com)** lets you ask questions in plain English and generates SQL + visualizations automatically. Just ask “show me revenue by product this quarter” and it writes the query and builds the chart — no SQL knowledge required.

**Key differences:**
– **Pulse AI:** Natural language → instant visual (30 seconds, no SQL needed)
– **Mode:** Write SQL → run query → configure chart (10-15 minutes per query)

**Ideal for:** Non-technical stakeholders, business teams, and anyone who needs insights faster than they can write SQL


Mode vs Other BI Tools

Feature Mode Looker Metabase Pulse AI
Price Free (limited) to $50-100/user/month $50-200+/user/month Free (self-hosted) or $85/user/month Free tier available
SQL required Yes LookML (SQL-like) Optional No
Target audience Data analysts Data teams Technical + business Non-technical users
Python/R support Yes No No No
Learning curve Medium-High High Medium Very Low
Best for Analyst-driven organizations Enterprises with data teams Startups, open-source lovers Business users who don’t write SQL

Mode’s unique strengths: SQL notebook interface, Python/R integration, built-in version control, analyst-friendly collaboration.


What to Do Next

Level up your Mode skills:
1. Learn advanced SQL: Window functions, CTEs, subqueries
– Mode has a free SQL School tutorial: mode.com/sql-tutorial
2. Use Mode definitions: Create reusable metrics
– Click workspace → Definitions → define metrics once, use everywhere
3. Automate with Mode API: Schedule queries, export results programmatically
– See Mode API docs for examples

Explore alternatives if Mode isn’t working:
– No SQL skills on team? Try Pulse AI (natural language queries) or Looker Studio (no-code)
– Need simpler interface? Metabase offers a friendlier UI for basic analytics
– Want more BI features? Power BI and Tableau offer richer visualization options


Frequently Asked Questions

Do I need to know SQL to use Mode?

Yes. Mode is designed for data analysts who write SQL. If you don’t know SQL, Mode offers a free SQL School tutorial to learn, but consider starting with a no-code tool like Pulse AI or Looker Studio.

How much does Mode cost?

Mode Studio: Free with limited features (great for personal use)
Mode Business: $50-100/user/month
Mode Enterprise: Custom pricing (typically $50,000+/year for larger teams)

Can non-technical users view Mode reports?

Yes. Viewers don’t need SQL skills to see dashboards and adjust parameters. But building reports requires SQL knowledge.

How does Mode compare to Looker?

Mode pros: Easier to learn, better notebook interface, Python/R support
Looker pros: More scalable for large teams, better data governance, LookML abstracts SQL

Choose Mode if: You want SQL flexibility and analyst control
Choose Looker if: You need strict data governance and centralized metrics

Is Mode suitable for small businesses?

Only if you have a data analyst on staff. Mode is built for technical users. Small businesses without SQL skills should use no-code tools like Looker Studio or Pulse AI.

Can I use Mode without a database?

No. Mode requires a database connection (PostgreSQL, Redshift, Snowflake, BigQuery, etc.). If your data is in Google Sheets or Excel, use a tool like Looker Studio or import the data into a database first.

What databases does Mode support?

PostgreSQL, MySQL, Redshift, Snowflake, BigQuery, Databricks, Presto, SQL Server, Oracle, and more. See Mode’s data sources page for the full list.


Related guides:
– SQL Tutorial for Business Analysts: Learn Mode’s SQL School
– Mode vs Looker: Which SQL-Based BI Tool is Better?
– Best Mode Analytics Alternatives in 2026