Settings
Everything that isn't day-to-day order / product / customer management
lives under /dashboard/settings. This page is
a quick tour of each section on the Settings page and what it
controls, with links out to the deeper references.
Who sees what
Most Settings sections are role-gated:
| Section | OWNER | ADMIN | MEMBER |
|---|---|---|---|
| Profile (name, email) | ✅ | ✅ | ✅ |
| Password | ✅ | ✅ | ✅ |
| Notifications (digest preferences) | ✅ | ✅ | ✅ |
| API keys | ✅ | ✅ | — |
| Webhooks | ✅ | ✅ | — |
| Audit log | ✅ | ✅ | — |
| Company name & slug | ✅ | ✅ | — |
| Pricing (tax rate, shipping) | ✅ | ✅ | — |
| Returns (return window) | ✅ | ✅ | — |
| Leave company | ✅ | ✅ | ✅ |
| Delete company | ✅ (single owner) | — | — |
See Roles & permissions for the full matrix across the app.
Profile
Your own name and email — used in the dashboard header, audit log actor labels, and notifications. Editing the email triggers a verification flow before the change takes effect.
Password
Set or rotate the password you use to log in. Does not change anything customer-facing.
API keys
Create keys for integrating external systems with the Distribu REST
API. Manage rotations and revocation from
/dashboard/settings/api-keys.
See API keys for the dashboard UI and Authentication for the API-consumer side.
Webhooks
Register HTTP endpoints to receive real-time event pushes. Twelve
event types are supported — see
Webhooks → Event types. Manage subscriptions
from /dashboard/settings/webhooks
or over the REST API.
Notifications
Per-user digest preferences — opt into a daily or weekly email
summary of your in-app notifications. Configured at
/dashboard/settings/notifications.
See Digest emails for cadence and delivery-window details.
Audit log
A chronological record of every significant action in your company — orders placed, status changes, logins, imports, webhook deliveries, subscription changes, returns. Filterable by actor type, entity type, and date range.
See Audit log for the event catalog.
Company settings
Only visible to OWNER and ADMIN roles:
- Company name & slug — the name shown in emails / invoices and
the slug used in your storefront URL (
/store/{slug}). - Pricing — default tax rate (0–30%, applied to all orders unless overridden per customer) and default shipping flat rate.
- Returns — the return window (in days) after delivery during
which customers can request returns from the storefront.
nulldisables storefront returns entirely; staff can still open returns from the dashboard.
Changing the slug affects your storefront URL — set up a redirect in your own marketing if you've been sharing the old URL.
Danger zone
Two destructive actions, both with typed-confirmation prompts:
- Leave this company — drops your membership. If you're the only OWNER, you can't leave until you promote someone else.
- Delete this company — only available to a sole OWNER. Permanently removes the company, all its data, and every membership on it. There's no undo. Cancellation of your Stripe subscription is handled separately through Billing.
Related:
- Team & roles — inviting users and assigning roles.
- Billing — plan & subscription management.
