Add @mm_project_role QGIS variable for the current user's project role

Open

#4,648 opened on Aug 12, 2026 1 comment 0 reactions 1 assignee View on GitHub

@xkello is already working on this.

Since Sep 21, 2026.

Assessment

Difficulty: 4/5
Estimated time: 3-5 days
Newbie friendliness: 48/100

Issue type: Feature
Clarity: Mostly clear
Activity status: Quiet
Tech stack: cpp
Domain: mobile-dev

Research direction

Start by tracing the existing mm_* variables in the mobile app and checking the plugin's displayed project-role values. Review the expression and form-default integration plus offline and sync handling; done means @mm_project_role returns the matching role, is empty in the stated inactive cases, and produces the same result in QGIS and the field.

Written by the indexing model from the issue text.

Description

enhancement forms

Current situation

The current user's role on a project isn't reachable from expressions, so authors can't set up expression-based behaviour that depends on the user's role.

What we want

A new Mergin variable, @mm_project_role, returning the current user's role on the active project, usable in expressions and form default values (like the other mm_* variables in the mobile app).

Expected behavior (user's view)

Returns the user's role on the open project as text.
Works offline and stays correct after syncing.
Empty when signed out or the project isn't a Mergin project.

The same expression must give the same result in QGIS and in the field, so the variable name and role values need to match the plugin exactly.

Role values users will see are reader, editor, writer, owner. Should mirror what the app already shows for roles.

Dominant language: C++
Stars: 388
Forks: 87
Avg merge: 4d 1h
Merged PRs (30d): 23

Contributor guide

Open the contributing guide

First steps

Read the whole issue, then the project's contributing guide.
Comment on the issue to say you are picking it up — it saves two people doing the same work.
Fork the repository and make your change on a branch.
Open a pull request that references the issue number.

Similar issues

`DropdownOption::open` is ignored Open

Difficulty 2/5 1-3 hours Newbie friendliness 86/100

ArthurSonzogni/FTXUI#1363 · Opened Sep 25, 2026
[openzl] examples/compress_app.cpp never writes the output file and reads input in text mode on Windows Open

Difficulty 2/5 1-3 hours Newbie friendliness 88/100

facebook/openzl#1053 · Opened Sep 24, 2026
Incorrect Int64 Type on DPCC for Windows Open

Difficulty 1/5 Under an hour Newbie friendliness 90/100

ginkgo-project/ginkgo#2108 · Opened Sep 24, 2026
[CI] Nightly Clang build broken: structured binding captured in a lambda in FileDataSource.cpp Open

bug build

Difficulty 1/5 Under an hour Newbie friendliness 91/100

facebookincubator/velox#19194 · Opened Sep 24, 2026
JIT-compiled number -> Decimal conversion silently overflows instead of raising DECIMAL_OVERFLOW Open

fuzz

Difficulty 2/5 1-3 hours Newbie friendliness 82/100

ClickHouse/ClickHouse#122114 · Opened Sep 24, 2026

More C++ issues