Skip to content

docs: Superset 6.1 documentation catch-up — batch 3 #39445

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
michael-s-molina merged 2 commits into from
Apr 29, 2026
+16 −1
Merged

docs: Superset 6.1 documentation catch-up — batch 3 #39445

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
4cf8f82
docs: Superset 6.1 documentation catch-up — batch 3
Apr 17, 2026
fbd27e7
Merge branch 'master' into docs/superset-6.1-catchup-3
michael-s-molina Apr 29, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions docs/admin_docs/configuration/importing-exporting-datasources.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,10 @@ Superset's ZIP-based import/export also covers **dashboards**, **charts**, and *
| └── ... (more databases)
```

:::note
When you export a database connection, the `masked_encrypted_extra` field (used for sensitive connection parameters such as service account JSON, OAuth tokens, and other encrypted credentials) is included in the export. When importing on another instance, these values are decrypted and re-encrypted using the destination instance's `SECRET_KEY`. Ensure the receiving instance has a valid `SECRET_KEY` configured before importing.
:::

## Exporting Datasources to YAML

You can print your current datasources to stdout by running:
Expand Down
2 changes: 2 additions & 0 deletions docs/admin_docs/security/security.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -191,6 +191,8 @@ However, it is crucial to understand the following:

By combining Superset's configurable safeguards with strong database-level security practices, you can achieve a more robust and layered security posture.

**Dataset Sample Access**: The `get_samples()` endpoint now enforces datasource-level access control. Users can only fetch sample rows from datasets they have been explicitly granted access to — the same permission check applied when running chart queries. This closes a prior gap where unauthenticated or under-privileged access could retrieve sample data.

### REST API for user & role management

Flask-AppBuilder supports a REST API for user CRUD,
Expand Down
2 changes: 1 addition & 1 deletion docs/developer_docs/contributing/development-setup.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -485,7 +485,7 @@ Frontend assets (TypeScript, JavaScript, CSS, and images) must be compiled in or

First, be sure you are using the following versions of Node.js and npm:

- `Node.js`: Version 20
- `Node.js`: Version 22 (LTS)
Comment thread
rusackas marked this conversation as resolved.
- `npm`: Version 10

We recommend using [nvm](https://github.com/nvm-sh/nvm) to manage your node environment:
Expand Down
9 changes: 9 additions & 0 deletions docs/docs/using-superset/exploring-data.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -329,6 +329,15 @@ various options in this section, refer to the
Lastly, save your chart as Tutorial Resample and add it to the Tutorial Dashboard. Go to the
tutorial dashboard to see the four charts side by side and compare the different outputs.

### Time Range Natural Language Expressions

The **Custom** time range picker accepts natural language expressions alongside specific dates. Superset supports a range of expressions including:
Copy link
Copy Markdown
Contributor

@bito-code-review bito-code-review Bot Apr 17, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Documentation inaccuracy

The documentation refers to the 'Custom' time range picker, but natural language expressions are actually supported in the 'Advanced' time range picker, which provides text inputs for 'since' and 'until' fields. The 'Custom' picker uses UI controls for building ranges. Please update the title and description to say 'Advanced' instead of 'Custom'.

Code Review Run #0f4a92

Should Bito avoid suggestions like this for future reviews? (Manage Rules)

  • Yes, avoid them

Copy link
Copy Markdown
Member Author

@rusackas rusackas Apr 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch — natural language expressions like Last 7 days and 30 days ago go in the Advanced picker (text inputs for since/until), not Custom (DatePicker/Radio/Select UI controls). This PR is already merged so I'll send the rename through in a follow-up PR to master.


- Relative: `Last 7 days`, `Last month`, `Last quarter`, `Last year`
- Anchored: `previous calendar week`, `previous calendar month`
- "First of" expressions: `first day of this week`, `first day of this month`, `first day of this quarter`, `first day of this year`, `first week of this year`
- Offsets: `30 days ago`, `1 year ago`, `next week`

### SQL Lab Tips

**Schema and table browser**: The left-side table browser uses a collapsible treeview — click a schema to expand its tables, and click a table to see its columns and sample data inline. This makes navigating large schemas much faster than the previous flat list.
Expand Down
Loading