Skip to content

Document that LD_SETUP_USER_ATTRIBUTES replaces assignments on declared attributes - #1741

Merged
jpetey75 merged 3 commits into
mainfrom
cloudy/docs-2026-11-12-change-5191dabc20eef855
Nov 19, 2026
Merged

jpetey75 merged 3 commits into
mainfrom
cloudy/docs-2026-11-12-change-5191dabc20eef855

Conversation

@lightdash-bot

@lightdash-bot lightdash-bot commented Nov 12, 2026 •

Copy link
Copy Markdown
Collaborator

The docs called the LD_SETUP_USER_ATTRIBUTES reconcile non-destructive and updated in place, so admins didn't know each deploy overwrites a declared attribute.

  • Declare user attributes warns once that every deploy replaces a declared attribute's description, default and assignments: unlisted groups are unassigned, an omitted default is cleared, per-user values are removed
  • Per-user mappings says to leave an attribute out of the array to manage it in the UI or API
  • User attributes page gets a one-line pointer
  • Clears a validator warning on User attributes: question heading

Review this PR individually. Close it to reject this change, then ask Cloudy to restack before merging.

Document that LD_SETUP_USER_ATTRIBUTES replaces assignments on declared attributes

Pages

What changes

  • Declare user attributes warns that every deploy replaces a declared attribute's description, default and assignments
  • Per-user mappings says to leave an attribute out of the array to manage per-user values
  • User attributes carries a one-line pointer

Why

The docs called the reconcile non-destructive and updated in place, so admins didn't know each deploy overwrites a declared attribute.

Checked against

Cloudy found this docs gap while working a support thread. Started from this internal Slack thread (Lightdash workspace only).

@github-actions

github-actions Bot commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

Documentation validation

✅ All blocking checks passed.

Component system

66 finding(s) across the corpus. Largest: prose.filler-word 22 · heading.question 22 · prose.anchor-index 12 · heading.overview 9 · prose.interface-narration 1.

Findings on lines this pull request touched are annotated inline in Files changed.

View the validation run.

@lightdash-bot
lightdash-bot force-pushed the cloudy/docs-2026-11-12-change-5191dabc20eef855 branch from ca13308 to 9847c4e Compare November 16, 2026 22:59
@lightdash-bot

Copy link
Copy Markdown
Collaborator Author

Restacked 6 docs PRs.
#1736
#1737
#1738
#1739
#1740
#1741

@mintlify

mintlify Bot commented Nov 16, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
lightdash 🟢 Ready View Preview Nov 19, 2026, 9:10 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

Cloudy and others added 3 commits November 19, 2026 15:10
- The deploy also clears a default left out of the entry
- One warning on the env var page; other mentions shortened or linked

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@jpetey75
jpetey75 force-pushed the cloudy/docs-2026-11-12-change-5191dabc20eef855 branch from b9854c1 to 4cc8241 Compare November 19, 2026 21:10
@jpetey75
jpetey75 merged commit 7639af9 into main Nov 19, 2026
7 checks passed
@jpetey75
jpetey75 deleted the cloudy/docs-2026-11-12-change-5191dabc20eef855 branch November 19, 2026 21:11

This branch was successfully deployed

1 active deployment
staging — 4cc82410 Deployed Nov 19, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants