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:

SectionOWNERADMINMEMBER
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. null disables 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.