Independent fieldbook· Documentation-led researchEvidence & limitations ↗
SOFTWARE FIELD NOTES / Relational spreadsheet

Grist

A spreadsheet-centered way to work with structured information. Its document model makes the distinction between a document backup and full installation recovery especially useful.

WHEN TO INVESTIGATE

Investigate Grist when your team wants spreadsheet-style work with related records. Evaluate a representative document instead of assuming your existing workbook translates directly.

THE IMPORTANT CONDITION

A downloaded document and a backup of the full installation have different scopes. Account access, external attachments and configuration need their own recovery plan.

PRIMARY-SOURCE RECORD

What the documentation establishes.

These are source-backed statements. The scope column keeps an edition claim separate from a test result.

Grist evidence notes · reviewed 1 November 2026
QuestionDocumented answerScope and source
Core licenceThe grist-core repository licence is Apache 2.0.Core repository main branch; other editions require their own review.Read primary source ↗
Document storageThe self-hosting guide distinguishes SQLite-based .grist document files from the home database that stores installation metadata.Documented storage model; configured installations may add other services.Read primary source ↗
Backup boundaryA downloaded .grist document excludes sharing information. External attachments need separate export and restoration.Document export guidance; not proof of complete instance recovery.Read primary source ↗
YOUR DECISION

Ask these first.

  • Which formulas and record relationships must the document represent?
  • Will attachments live inside the document or in external storage?
  • How will the restored installation recover users, sharing and configuration?

Our evaluation approach: a candidate stays on the shortlist only when it meets your essential workflow and your team can maintain it. This is editorial guidance, not a product test score.

A PRACTICAL REHEARSAL

Make the choice observable.

  1. Create a synthetic document with two related tables and a calculation.
  2. Include an attachment and record its storage location.
  3. Download the document and reopen it in a separate test destination.
  4. Check formulas, linked records and attachment availability.
  5. Separately inventory the home database, authentication and storage configuration.

Suggested evaluation steps. This site has not completed this rehearsal or measured its success rate.

WORK WITH Grist

Choose the guide for your next task.

Migration guide

Grist CSV and Excel Imports Without Silent Data Changes

Prepare CSV and Excel data for Grist, choose a merge key, inspect import previews and reconcile records before accepting an import.

Read the workflow ↗
Workflow guide

Grist Reference Columns: Link Records by Identity

Understand Grist reference columns, reference lists and display labels, with a customer/project example and checks for ambiguous matches.

Read the workflow ↗
Technical reference

Grist Formulas: Validate Calculations Before Reuse

Plan and validate Grist formula columns with Python-aware identifiers, boundary cases and a worked service-invoice calculation.

Read the workflow ↗
Workflow guide

Grist Summary Tables: Reconcile Groups and Totals

Choose meaningful group fields in Grist, distinguish sums from averages and reconcile a hypothetical project-status report.

Read the workflow ↗
Workflow guide

Grist Linked Widgets: Build a Clear Master–Detail Page

Plan Grist selection and filter links with a customer/project example, then check empty states and avoid confusing layout with security.

Read the workflow ↗
Technical reference

Grist Access Rules: Verify Who Can Read and Change Data

Plan a Grist permission matrix, distinguish filters from access controls and verify allowed and denied behavior using synthetic accounts.

Read the workflow ↗
Workflow guide

Grist Forms: Design and Verify a Submission Workflow

Build a Grist form around a clear destination table, test required fields and inspect the difference between previewing and publishing.

Read the workflow ↗
Technical reference

Grist REST API: Identify Records Before Automating Writes

Plan a Grist API integration using documented bearer authentication, table and column IDs, read-first checks and controlled update behavior.

Read the workflow ↗
Workflow guide

Grist Document Backups: Know What a .grist File Preserves

Distinguish a Grist document download from full installation recovery and plan a synthetic restore check with sharing and attachment boundaries.

Read the workflow ↗
Technical reference

Grist External Attachments: Keep Files and Records Recoverable

Understand the recovery boundary of external Grist attachments, prepare paired artifacts and reconcile files after restoring a document.

Read the workflow ↗
Technical reference

Grist Self-Hosting Storage: Inventory the Persistent State

Map Grist documents, home metadata, sessions and configured external services so an installation recovery plan covers more than one file.

Read the workflow ↗
Technical reference

Grist Authentication: Plan OIDC or SAML With an Access Check

Separate Grist sign-in from document authorization, check current edition requirements and validate identity-provider changes without guessing configuration.

Read the workflow ↗
INTERFACE SPECIMENS / ANNOTATED

Inspect the interface, with its context.

Open a specimen to see the source image and the observations it supports. A vendor demonstration is distinct from a self-hosted installation.

GristOfficial public demo · Demo identifies v1.7.20
Official public demoDemo identifies v1.7.20
Grist official Lightweight CRM demo showing a contact list, selected contact card and interactions table with fictional sample data.
The official Lightweight CRM template combines a contact grid, a detail card and an interactions table. The demo identifies its sample data as fictional. This hosted v1.7.20 demo is separate from the v1.7.21 core licence check.
  1. Contact gridThe left widget lists sample companies and follow-up tasks.
  2. Detail cardThe upper-right widget presents fields for the selected contact.
  3. Related interactionsThe lower-right widget displays the sample interaction history.
Interface and sample template © Grist Labs. Browser capture by OwnStack Atlas; numbered annotations are separate overlays. Reviewed 25 October 2026.Open official source ↗Enlarge original ↗
WHAT IS STILL UNKNOWN

Evidence we are still building.

We have not established independent resource measurements, migration completeness, restore reliability or a full edition-by-edition permission matrix. The interface evidence above retains its original capture date and version; it is not a new installation test.