User Settings
Summary
User Settings provide persistent per-user storage for extension data. Settings are scoped to the user and persist across all documents. Use this for preferences, configuration, and user-specific data.
Overview
- Store per-user preferences (theme, language, defaults)
- Data persists across documents and browser sessions
- Key-value storage model (values must be strings)
- All operations return Promises
Sub-Sections
- Fetch User Settings — Retrieve stored values by key
- Add User Settings — Store or update values
- Delete User Settings — Remove stored values
API Reference
// Fetch a value
SigmaSDK.WRITER.storage.user.fetch("key")
.then(value => console.log(value));
// Add / Update a value
SigmaSDK.WRITER.storage.user.add({ key: "key", value: "value" })
.then(() => console.log("Saved"));
// Delete a value
SigmaSDK.WRITER.storage.user.delete("key")
.then(() => console.log("Deleted"));Scope Comparison
| Feature | User Settings | Document Settings |
|---|---|---|
| Scope | Per user | Per document |
| Persists across documents? | Yes | No |
| Use Case | User preferences, API keys | Document notes, config |