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:
- Click your workspace name (top-left) → Settings
- Go to Data Sources
- Click + New Connection
- Select database type:
- PostgreSQL, MySQL, Redshift, Snowflake, BigQuery, Databricks, etc.
- Enter connection details:
- Host/endpoint
- Port
- Database name
- Username and password (read-only credentials recommended)
- 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:
- Click + New (top-right) → Report
- 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:
- 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;
- Click Run (or Cmd/Ctrl + Enter)
- 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:
- After running your query, click + Chart (bottom of results)
- Mode opens the Chart Builder
- Choose chart type: Bar chart
- Configure:
- X-axis: Select your dimension column (product_name)
- Y-axis: Select your metric column (total_revenue)
- 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:
- Click + Query in the notebook
- 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;
- Run the query
- + 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:
- 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;
- Click Run
- Mode prompts you to enter a value for
start_date - 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:
- Click + Python Notebook in your report
- 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)
- Run the Python code
- 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:
- Click View Report (top-right) to exit edit mode
- Click Edit → Add to Dashboard (for each chart you want)
- Drag charts to position them
- 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:
- Click Share (top-right)
- Add people: Enter emails or select user groups
- Set permissions:
- Viewer: Can see the report and run queries
- Editor: Can modify SQL and visualizations
- Admin: Full control
- Click Share
Schedule email delivery:
- Click Report Actions (three dots) → Schedule Report
- Choose frequency: Daily, weekly, monthly
- Select recipients
- Choose format: PDF, CSV, or link
- Save schedule
Mode sends report snapshots automatically.
Embed in website or app:
- Report Actions → Embed
- Copy the embed code (iframe)
- 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:
- Click Comments (speech bubble icon)
- + New Comment
- @mention teammates to notify them
- 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):
- Open someone else’s report
- Click Report Actions → Fork
- 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:
- Click Home → + New Collection
- Name your collection (e.g., “Sales Analytics”, “Marketing KPIs”)
- 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


