Author / Auteur : Said Hamadou (HmD) License / Licence : Apache-2.0
A Grist custom widget to visually manage document access rules. Control read/write permissions per table, column, and row — all from a simple interface.
This widget is for document Owners only. Other users (Editors, Viewers) do not need it — they are simply subject to the rules configured by the Owner.
- Auto-detection: Grist instance URL and document ID are detected automatically
- Users tab: View and change user roles (Owner, Editor, Viewer)
- Tables tab: Visual matrix of read/write permissions per table
- Columns tab: Detailed permissions per column for each table
- Rules tab: View all custom ACL rules with conditions and permissions
- Bilingual: French / English interface (auto-detected from browser)
- Secure: API key stored in session only (or optionally in local storage)
- Compatible: Works with Grist SaaS (docs.getgrist.com) and self-hosted instances
- Add the widget to your Grist document as a custom widget
- Use the URL:
https://isaytoo.github.io/grist-access-rules-widget/ - Grant full access when prompted
- Enter your API key (Owner rights required)
- The widget auto-detects your Grist URL and document ID
- Click your avatar in the top right corner of Grist
- Go to "Account Settings"
- Section "API Key" → click "Create"
- Copy the key and paste it in the widget
| File | Description |
|---|---|
index.html |
Widget UI (HTML + CSS) |
widget.js |
JavaScript logic (i18n, API, ACL management) |
package.json |
Metadata with grist widget configuration |
LICENSE |
Apache-2.0 license |
| Endpoint | Purpose |
|---|---|
GET /api/docs/{docId}/access |
List users and roles |
PATCH /api/docs/{docId}/access |
Change user roles |
GET /api/docs/{docId}/tables |
List tables |
GET /api/docs/{docId}/tables/{id}/columns |
List columns |
GET /api/docs/{docId}/tables/_grist_ACLRules/records |
Read ACL rules |
GET /api/docs/{docId}/tables/_grist_ACLResources/records |
Read ACL resources |
Requires full document access and an Owner-level API key.
Widget Grist personnalisé pour gérer visuellement les règles d'accès d'un document. Contrôlez les permissions de lecture/écriture par table, colonne et ligne — depuis une interface simple.
Ce widget est réservé aux propriétaires (Owners) du document. Les autres utilisateurs (Editors, Viewers) n'en ont pas besoin — ils sont simplement soumis aux règles configurées par l'Owner.
- Auto-détection : L'URL de l'instance Grist et l'ID du document sont détectés automatiquement
- Onglet Utilisateurs : Voir et modifier les rôles (Owner, Editor, Viewer)
- Onglet Tables : Matrice visuelle des permissions lecture/écriture par table
- Onglet Colonnes : Permissions détaillées par colonne pour chaque table
- Onglet Règles : Voir toutes les règles ACL personnalisées avec conditions et permissions
- Bilingue : Interface français / anglais (détection automatique du navigateur)
- Sécurisé : Clé API stockée en session uniquement (ou optionnellement en stockage local)
- Compatible : Fonctionne avec Grist SaaS (docs.getgrist.com) et instances auto-hébergées
- Ajoutez le widget à votre document Grist comme widget personnalisé
- Utilisez l'URL :
https://isaytoo.github.io/grist-access-rules-widget/ - Accordez l'accès complet quand demandé
- Entrez votre clé API (droits Owner requis)
- Le widget détecte automatiquement votre URL Grist et l'ID du document
- Cliquez sur votre avatar en haut à droite dans Grist
- Allez dans "Paramètres du compte"
- Section "API Key" → cliquez "Créer"
- Copiez la clé et collez-la dans le widget
| Fichier | Description |
|---|---|
index.html |
Interface du widget (HTML + CSS) |
widget.js |
Logique JavaScript (i18n, API, gestion ACL) |
package.json |
Métadonnées avec configuration widget Grist |
LICENSE |
Licence Apache-2.0 |
Nécessite l'accès full au document et une clé API de niveau Owner.