Ballad
Surface

Settings

You, the workspace and its roles, what Ballad writes with, and where it connects: the fourteen pages behind everything else, from My Account to Email.

~5 min5 sectionsNext.js App Router

Settings is fourteen pages, each one the answer to a different question, grouped in the rail under four headings: You, Workspace, Content and Connections. Most of it you'll set once during the walkthroughs and not think about again.

You

My Account is you: your name, your photo, the address you sign in with, light or dark, and how you leave.

My Link Page is your ballad.to page, edited in place: your portrait and bio, the one call to action, and your links. It shows your latest writing on its own.

My Notifications is what reaches you in Slack: which Inbox sections come to you as direct messages (until you change them, the workspace's choices), your quiet hours in your own timezone, and a test message. See Connect Slack.

My Agents is where Claude and your own tooling connect: the connector URL, agent keys and their scopes, the apps you've authorised, and every call they made. It has its own page.

Workspace

Workspace is the company Ballad works for: its name, its members, open invites, single sign-on (Business), support access, and deleting it.

Under Members, Invite people takes an email address and a role, and Ballad emails that person a single-use invite link. Open invites are listed below it, each with Resend and Revoke. Each person who joins gets their own voice. Every workspace has four roles:

RoleWhat they can do
OwnerEverything. The person who created the workspace starts as its owner.
AdministratorEverything except transferring ownership or deleting the workspace.
UserEdit, approve, schedule and decline the pieces in their own voice, edit that voice's settings, and use Ask Ballad. Everything else is view-only.
ViewerSee everything, change nothing. No Ask Ballad.

Invites default to User. Owners and administrators invite and remove people and change roles. The owner can hand the workspace to someone else with Make owner, and stays on as an administrator. Whatever the role, your own theme, timezone, photo and email updates stay yours to change.

Your plan sets how many people can be Owners, Administrators and Users (2 on Founders, 5 on Startup, unlimited on Business), open invites included. Viewers are free on every plan, in any number. At the limit you can still invite Viewers; the other roles say they're full and offer the upgrade.

Single sign-on (Business) is set up on the same page by the owner: add your identity provider (Okta, Google Workspace, Microsoft Entra, or another SAML or OIDC provider) for your email domain, then prove the domain with the DNS TXT record Ballad gives you and press Check the record. People on that domain who sign in through it join the workspace as Users. Require SSO makes it the only way in for that domain; people outside it, such as an agency or an advisor, sign in as before.

Billing is your plan: which one you're on and when it renews or the trial ends, and what it includes against what you've used (users, questions in AI answers, competitors, keyword data this month, the site audit). Upgrade goes to checkout for Startup (monthly or yearly) or Business (yearly), where a promo code can go in; Manage billing opens the billing portal for your card, invoices, plan changes and cancelling. The owner changes the plan; administrators can see the page; other roles don't see it. See Pricing.

Onboarding is what Ballad does here: one row per kind of marketing (the same four choices as onboarding), each showing whether it's on and what it's writing. Turning one on later adds its setup walkthrough to your Inbox.

Content

Voices is who speaks. There's you and there's the company, each with its own channels, its own formats, its own cadence, and its own connected accounts: your X and LinkedIn for the founder voice, the company's for the brand.

Each voice also carries the notes that make its drafts sound right: the terms it uses and never uses, the distinctions that matter in your field, and a few things you've actually written. A term you correct in review joins the list on its own.

A voice's Who handles it section decides where its items go: to its person, to delegates (teammates who approve, edit and schedule for them, as for a CEO who doesn't approve their own posts), or both. The voice's person or an owner or administrator sets it; the company voice goes to its delegates, or to owners and administrators.

Brand is one look for the whole workspace: logo, colours and font. Every image post, carousel and article cover renders in it, whichever voice is speaking.

Collections are your long-form lanes: a blog, a founder journal, a changelog. Each has a subject, a cadence, where it publishes (Ballad as your CMS, or your own CMS, shown as a tag in the list), how often a depth piece is due, and how articles open. A blog can have several authors, each with a share of its articles; the list shows every author.

Changelogs is the product side of that: what you sell, the secret your repository posts releases and commits with, and how often commits get digested into a note. See Release notes and changelog.

Connections

Site is the wiring between Ballad and your website:

  • Your site's URL, and the pages Ballad has read from it.
  • The attribution beacon snippet and its token.
  • Your content API key, for rendering articles on your own domain.
  • Web analytics: Google (Search Console, for rankings, and Analytics) or Vercel.
  • Landing pages, if Ballad publishes them for you.
  • The search market: the country and language your buyers search in.

Email holds the workspace's email accounts, which is how newsletters and sequences get sent. An account is a provider (Resend for now), its API key, a default from address, an optional reply-to, and the postal address list emails need in their footer. Add the key once here; each voice then picks an account under its Email tool row in Voices, and can set its own from address and reply-to. Owners and administrators manage accounts. See Connect Resend for sending.

Slack is the workspace's connection: connect, reconnect or disconnect, send any pending drafts, and the shared channel, where Post workspace news to the shared channel and What reaches the channel choose the news it gets. Owners and administrators connect it. Each person's own Inbox comes to them as direct messages. See Connect Slack.

Next

Next guideMy Agents