Workspaces
Create, switch between, and configure workspaces — including branding and dangerous owner-only actions.
A workspace is one blog. Each workspace is an independent tenant — its posts, members, API keys, and branding live entirely under it. You can belong to as many workspaces as you like, and switch between them from the dashboard's workspace switcher in the top-left.
This page covers the four things you'll do from the workspace settings: editing the general details, setting branding, transferring ownership, and (rarely) deleting the workspace.
Create a workspace
From the dashboard home, click New workspace. Fill in:
- Name — what you want to call this blog. Visible in the workspace switcher and as the default site name.
- Slug — a short URL-safe identifier (lowercase letters, numbers, dashes). Slugs are unique across the whole platform — if someone else already has the slug you want, Clog will tell you and you'll need to pick another.
- Description (optional) — a one-line note for yourself and your teammates.
You become the workspace owner automatically. The owner role is the only one that can transfer ownership or delete the workspace; everything else is governed by per-member permissions (see Members and permissions).
Switch between workspaces
The workspace switcher sits at the top-left of the dashboard. Click it to see every workspace you're a member of and jump between them. The URL changes from /workspaces/<old-id>/posts to /workspaces/<new-id>/posts — the page you were on stays the same; the data swaps.
If you don't see a workspace you expect to be a member of, ask the owner to check the Members page — your membership may have been removed.
Settings → General
Open Settings → General to edit the workspace's basic details. You need the settings:write permission (or to be the owner) to make changes. Without it, the form is read-only and shows a note explaining what's missing.
| Field | What it does |
|---|---|
| Name | The display name across the dashboard and in workspace branding. |
| Slug | The URL identifier. Changing it changes the URL of every dashboard page for this workspace. Plan ahead — bookmarks and direct links to the old URL will 404. |
| Description | An internal-only one-liner. Not shown to external readers. |
| Canonical URL | The base URL of the public site this workspace's content gets rendered on (e.g. https://example.com/blog). Used as a default fallback for SEO canonical tags. |
| Default locale | A BCP-47 locale code (e.g. en, en-US, de-DE). Used as a default in SEO metadata. |
Click Save to apply.
Settings → Branding
Open Settings → Branding to set the visual identity that ships out through GET /external/workspace. Consumer sites pull these to theme their own frontend or to render a "Powered by" footer.
| Field | What it does |
|---|---|
| Primary color | Main brand color. Pick from the color wheel or paste a #RRGGBB hex. |
| Secondary color | Optional accent. |
| Accent color | Optional second accent. |
| About (Markdown) | A short Markdown description shown on the public site. Up to ~5,000 characters. Plain prose, light formatting — links, bold, italics. |
| Logo | The workspace logo. Drag-and-drop or pick an image/png, image/jpeg, image/webp, or image/svg+xml file up to 5 MB. The current logo previews live; Replace swaps it, Remove clears it. |
The brand logo is stored separately from the regular Media library — Media is for post content. There's no media-row to manage; the file lives directly on the workspace.
Brand fields require settings:write (or owner).
Danger zone — owner-only
At the bottom of the settings page (visible only to owners) sits the Danger zone. Two actions live here.
Transfer ownership
Click Transfer ownership to move the owner role to another existing member. The dialog lists everyone who is currently a member of the workspace; pick the new owner and confirm.
What happens:
- The target user becomes the workspace owner.
- You stop being the owner — you keep your membership and are automatically granted every permission, so nothing breaks operationally. You just lose owner-only actions (deleting the workspace, future ownership transfers, editing the new owner's permissions).
- The change is atomic. There is never a moment with two owners or no owner.
To strip your own access after transferring, the new owner can edit your permissions in Members.
The new owner must already be a member of the workspace. If they aren't, invite them first (Members → Invite member), have them accept, then transfer.
Delete the workspace
Click Delete workspace to remove this workspace and everything in it.
This is a hard delete with no undo. Posts, pages, categories, tags, authors, media, members, API keys, redirects, link-health entries — all gone. The brand-logo file is removed from storage too. To prevent fat-finger deletions, the confirmation dialog asks you to type the workspace's slug exactly.
If you ever want to "pause" a workspace instead of deleting it, an alternative is to revoke all non-owner memberships and stop using it — you can always come back later.
Where to go next
- Members and permissions — invite teammates and decide what they can do.
- API keys — issue programmatic access for your own site or service.
- Posts — write your first article.