Guided Theme Setup
What it helps you do
Launch a new Dirigible site from a short question instead of a long wizard. Theme Setup builds a first draft of the site (look, pages, contact details and plugins), shows it on a live preview of the real site, and saves nothing until you press Use this.
Where to find it
- Appearance → Theme Setup — opens Theme Setup full screen.
- On first activation of Dirigible (or a Dirigible child theme), WordPress takes you there automatically.
- Dirigible → Flags (Administrators) — Reset Theme Setup stamps makes the next run count as a first run.
How to use it

| Screen | What you do |
|---|---|
| What are we building? | Business name and what it does; optionally the kind of business, which picks the stock photos, suggests pages and words the sample text. Paste your site license: it's checked while you type the rest, and your plan's plugins install in the background. An optional OpenRouter key turns on AI page wording, logo generation and the social profile search; leave it empty to set up without AI. Pull from my old site takes a current site's address: its colors, logo, contact details and social links become the starting point. Press Let's go. |
| Pick a direction | Six previews of your home page, each in a different palette and font pairing. With an old site, the first is its own colors and logo, and the others keep its logo and details. Start with this opens one; Show more brings six others. |
| Make it yours | A live preview of the real site. Click the logo, a heading, a button, the menu, the footer or a photo to open its tab: Colors (lock colors, Shuffle for new ones that stay readable, or start from a set), Fonts, Logo, Photos, Pages (what the site needs: each adds its page and, where your plan has it, its plugin) and Details (email, phone, address and social links). Plugins can add a tab: Better Breeder adds Breed. Press Use this when it's right. |
| What's left | The list of what to do before launch, starting with any contact details left empty. |
Leave without changes, at the top of every screen, closes Theme Setup and drops what you picked.
What happens automatically
- Nothing is saved until Use this: your choices wait in a draft and preview on the real theme.
- The draft's pages are WordPress drafts under Pages. Changing the name, description or pages writes them again: a draft page you edited moves to the trash (restore it from there), and one you published stays and is used as that page.
- The child theme is made when you press Let's go, named after the business. If it can't be made, setup carries on with the parent theme and plugins still install.
- Use this saves the palette, fonts, logo, details and social links, publishes the pages, sets the home page and menus, and installs the plugins your Pages choices need.
- A new site is hidden from search engines until you choose Allow indexing on the dashboard. A site with any content of its own (posts, pages, products, events, dogs, portfolio items) is never hidden.
- WordPress's "Hello world!" post and Sample Page move to the trash, but only while they are exactly as WordPress made them.
- With an old site address, what Theme Setup can read from it goes into the draft with no extra clicks: empty contact details and social links are filled, its logo is copied into the Media Library with a reverse logo made from it, and its colors become the palette, listed as From your old site under Colors so you can go back to it after trying others. Its own colors start locked, so Shuffle keeps them. If they make a hard-to-read pair, the usual contrast warning shows; the colors are never changed for you. Anything it can't find is left empty, and if the site can't be read, setup carries on without it.
- With an OpenRouter key and an old site, the social profile search runs by itself and fills the Details tab for you to check. Without a key nothing calls OpenRouter.
- The stock photos your pages show are downloaded into the Media Library and become your Default Images.
Things to know
- Running Theme Setup again changes only what you pick: colors, fonts, logo and details. Your pages, home page, menus and search engine setting stay as they are, and new pages are made only if you add them on Pages. The first direction is your current look, so keeping it and pressing Use this changes nothing.
- OpenRouter usage is billed to your OpenRouter account, not to Dirigible. The key is kept under AI → Settings.
- You can change anything later in Appearance → Customize or on individual pages.
- Theme Setup works on a phone: the tabs open as a sheet under the preview.