Run Theme Setup on a new site
Theme Setup builds a first draft of a new Dirigible site from a few answers and shows it to you before anything is saved. You pick a look, change what you like on a live preview of the real site, and press Use this when it's right. Nothing changes on the site until then.
Start Theme Setup
- Log in to WordPress. On a new site, Theme Setup opens by itself the first time the theme is activated.
- Otherwise, go to Appearance → Theme Setup.
Answer the question

- Business name and What does it do? are enough for a first draft. The sample text on your pages is written from them.
- What kind of business is it? is optional. It picks the stock photos, suggests the pages the site needs and words the sample text.
- Site license: paste your site license (it starts with
ds_site_). It's checked while you fill in the rest, and your plan's plugins install in the background. See Add your Dirigible license key. - OpenRouter key (optional): leave it empty to set up without AI. With a key, Theme Setup can write your page wording, suggest logos, and look for your social profiles. The key is kept under AI → Settings, where you can change or remove it. Usage is billed to your OpenRouter account. The field doesn't show once a key is saved.
- Pull from my old site: type your current website's address. Its colors, logo, email, phone and address become the starting point. With an OpenRouter key, Theme Setup also searches the web for your social profiles and fills them in for you to check.
Press Let's go. The child theme is made then, named after your business. See Use a child theme.
Pick a direction

Each preview is your home page in one of Dirigible's palettes and font pairings. Pick the closest with Start with this: everything can change in the next step. Show more brings six others.
Make it yours

The preview is the real site with your choices on it. Click anything on it (the logo, a heading, a button, the menu, the footer, a photo) to open the tab that changes it.
| Tab | What you do |
|---|---|
| Colors | Press a color to change or lock it. Shuffle works out new colors from color rules and keeps text readable; locked colors stay. Undo goes back. Or start from one of the sets below. |
| Fonts | Pick a font pairing for headings and text. |
| Logo | Upload your logo. A version for dark backgrounds is made from it. With an OpenRouter key you can also generate one. |
| Photos | Swap a stock photo for another, by kind of business. |
| Pages | What the site needs: each choice adds its page and, where your plan has it, its plugin. |
| Details | Email, phone, address and social links. The footer in the preview shows each one. Empty ones are left off the site, and the button beside Use this counts them. |
Plugins can add their own tab. On a Better Breeder site, Breed sets the breed the kennel is known for.
Other directions goes back to the six looks. Press Use this when you're happy.
What's left

Theme Setup ends with a list of what still needs doing before launch, starting with any contact details you left empty. A new site stays hidden from search engines until you press Launch site on the dashboard. See Launch your site.
Running it again
On a site where Theme Setup has run before, it says so on the first screen. Running it 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 the Pages tab. The first look offered is your current one, so keeping it changes nothing.
Leave without changes, at the top of every screen, closes Theme Setup and drops what you picked there.
What to do after setup
- When the sample text and photos are replaced: Launch your site.
- Fine-tune your palette and type: Set your site colors and fonts and Choose a font from the Dirigible Fonts library.
- Adjust the logo and header: Add your logo and set up the site header.
- Name the site and add its browser-tab icon: Set your site title, tagline, and favicon.
- Choose the page visitors land on: Set your homepage.
- Add Google Analytics and other tracking once the site structure is settled. See Add tracking codes to your site.