Getting Started
Here are the first steps on a new Dirigible site: run the setup wizard, find your way around the Customizer, and build your first page.
Browse documentation in WordPress
Open Dashboard → Documentation to read Dirigible Support docs inside wp-admin. Pages that map to a Customizer section or admin screen on your site show an Open button that launches that destination in a new tab.
See In-Admin Documentation for details.
Run Theme Setup first (recommended)
On a fresh install, WordPress may send you to Appearance → Theme Setup automatically. You can also open it anytime from the admin sidebar.
Theme Setup asks for the business name, what it does and your site license (your plan's plugins install in the background), then shows six looks for your home page. Pick one, adjust colors, fonts, logo, photos, pages and contact details on a live preview of the site, and press Use this: your look, pages and details go live then.
Full guide: Guided Theme Setup.
Open the Customizer
Most site-wide choices live in one place:
- Go to Appearance → Customize.
- Open a Dirigible panel on the left: Styles, Settings, Header & Menus, Footer & Contact, and more.
- Change a setting. The preview on the right updates as you go.
- Click Publish to make the changes live.
Not ready to go live? Open the menu beside Publish, choose Save draft, then click the button, which now reads Save draft. The draft is kept, and the site doesn't change. While a draft is waiting, the Customizer keeps saving to it and says You're editing a draft at the top. Click Publish now there when the changes are ready to go live.
Global Styles and Live Preview explains how colors, fonts, and widths set here carry through every page.
Suggested order for a new site
You don't have to follow this exactly, but most sites come together in roughly this order:
| Step | What to do | Learn more |
|---|---|---|
| 1 | Finish Theme Setup, or skip it and set things up by hand | Guided Theme Setup |
| 2 | Choose site colors and fonts | Palette and Typography |
| 3 | Set content widths | Widths and Layout |
| 4 | Build the header and menus | Header Setup |
| 5 | Add footer contact details and a footer logo | Footer and Contact |
| 6 | Set up blog cards and single posts | Blog Cards and Single Posts |
| 7 | Build pages in the block editor | True-to-Site Block Editor |
Settings worth checking early
Under Customize → Settings:
- General: your 404 page, page background color, image lightbox color, and whether the header and footer run full width.
- Animations: page-load and scroll effects (see also Magic Classes and Scroll Animations).
- Search Results Page: the message shown above site search results.
- Contact details: your address, phone and email, for the footer and search engines.
- Social profiles: profile links used by social icons, the Socials block, and search engine data.
Build your first page
- Go to Pages → Add New.
- Give the page a title.
- Click + and insert Dirigible blocks (Hero, Section, Columns, and others).
- Use the block sidebar to adjust layout, colors, and content.
- Click Publish.
The editor loads your theme styles, so the canvas looks close to the live site. For media tips, see Smarter Media Library and Image Focal Points.
Back up or move settings
Before a big redesign, export your styles and settings from Dirigible → Import/Export (Administrators). You can restore them on the same site or copy them to another one.
Details: Import and Export Theme Settings.
Related guides
- Palette and Typography
- Widths and Layout
- Header Setup
- Tools: cache, media, and cleanup tools
Your Dashboard
Dashboard → Home opens on what needs attention: search engines blocked, a missing or expired license, or emails that failed this week. When nothing does, it says so in one line. Below that are quick links for your role, your recently edited content, Analytics if it's on, and this site's logo, palette, fonts and active Dirigible plugins.
For a few weeks after Theme Setup, Administrators also see a short setup list. It ticks itself off as the site gets ready and goes away when it's done.
Site → Site Sheet has the full reference: every palette color with its hex value, both logos, the fonts and a typography specimen, the Form Parameters you can use in Gravity Forms, and the changelog.
Add Dirigible plugins
Open Dirigible → Extensions. A badge at the top shows the site license. With no license yet, Add site license takes you to Dirigible → License: paste your key and click Activate. Site keys start with ds_site_. If the key is refused, the reason appears under the field. A license past its end date shows Expired there and on the Extensions badge, and Dashboard → Home lists it: the site gets no new Dirigible updates until it's renewed (extensions still install, at their last release before that date). After renewing, click Re-activate on Dirigible → License (or wait a day for the daily check).
Each Dirigible plugin has a card with a short description, a Docs link and its status:
| Mark | Meaning | Button |
|---|---|---|
| Green check | Active, with a license | none |
| Yellow check | Included in your plan (or licensed), not installed or switched off | Install or Activate |
| Orange ! | Active without a license, not in your plan, or the license has expired, so it gets no updates | none |
| Empty circle | Not in your plan, or not installed and no license yet | Activate if it's installed |
Your plan decides which plugins the site gets: the cards of plugins outside it say Not in your plan.
Install downloads the plugin from Dirigible and activates it, so there's no zip to find and upload. The card shows Installing…, then turns green with "Installed and active" and a Reload link: the plugin's own menu appears after the next page load. Activate works the same way for a plugin that is installed but switched off. Nothing reloads on its own.
The page is built for browsing what you can add. The top shows your plan, with a Manage license link (or Add site license when there's none). Start here comes first while any of the five plugins most sites need isn't installed: Blocks, Fonts and Optimize (marked Essential, the base of every Dirigible site) and SEO and AI (marked Recommended). On this site lists the Dirigible plugins installed here, each with its status and Docs link; one that's switched off has Activate. Explore lists the other plugins your plan includes that aren't on the site yet, each with a short description, Docs and Install. Type in Search extensions, or click a category (Build your site, Run your business, Show your work, Speed and search, Share knowledge) to narrow the list. Plugins outside your plan aren't listed as cards; a line at the bottom names them (for example, "Store isn't in your plan."), or the first three and how many more when there are more than four. On a Better Breeder plan, Better Breeder and Better Breeder Extended are listed under Start here too. Store adds to WooCommerce, so install WooCommerce before it: without WooCommerce, Store installs but does nothing. Without a site license, the cards say Needs a site license, and Add site license at the top opens Dirigible → License. A plugin you install or activate moves up to On this site.
Only administrators who can install plugins see the buttons, and only people who can manage the site see the badge and the key field. On a site that blocks file changes (DISALLOW_FILE_MODS), plugins have to be copied into wp-content/plugins instead.
Keep Dirigible up to date
Theme and plugin updates show up under Dashboard → Updates, like any other WordPress update. The Dirigible theme and every Dirigible plugin update automatically: WordPress checks twice a day and installs new Dirigible releases in the background, so on the Plugins screen their auto-update setting shows as on and can't be switched off there. Your other plugins keep their own setting. On the Plugins screen each Dirigible plugin shows its colour tile before its name, the same icon as on Dashboard → Updates, so ours stand out at a glance; other plugins show the icon WordPress.org has for them, or a grey plug when it has none, and an inactive plugin's icon is greyed out. Updates need an active site license on Dirigible → License (a product key saved for a plugin before site licenses still works for that plugin). Installed Dirigible plugins that aren't active get updates the same way, so they don't fall behind (updating one doesn't activate it).
A site license is one key for the theme and every Dirigible plugin on the site. Paste it under Site license on Dirigible → License and click Activate. Site keys start with ds_site_. Once it's active, the page shows your plan's name, and your plan decides which plugins you can install and which products get updates. While it's saved, it's used instead of any product keys saved before. Those product keys stay saved and apply again if you remove the site license: while there's no active site license, the page lists them under Product keys, with Re-activate and Remove. There's no field for a new product key. A site license belongs to one site address: after moving the site to a new domain, the section explains why it stopped, and Re-activate sets it up for the new address. Dirigible asks the licensing server once a day what your plan includes, so plugins added by a plan upgrade show Install within a day; re-activating the key shows them straight away.
While an update is replacing the theme's or a plugin's files (usually a few seconds), a visitor who lands mid-way gets a short "This site is updating, refresh in a minute" page instead of a broken page or an error. Browsers and the host's cache retry it on their own.
Dirigible Studio publishes the exact files of every Dirigible release, and the theme compares an update with them before it installs. If an update's files don't match, an alert appears in wp-admin: please let Dirigible Studio know. Zips you upload yourself (Plugins → Add New → Upload Plugin) aren't checked.
To keep a site on its current Dirigible versions (for example while you test something), add define('DS_AUTO_UPDATES', false); to wp-config.php. Updates still appear under Dashboard → Updates for you to install by hand.
A site on a site license asks the licensing server about all the Dirigible products it is checking in one request, both in the background and when you click Check for updates, instead of one request per product. Nothing else about updates changes: if that one request fails, the site checks each product on its own as before. Sites on product keys, and checks run with WP-CLI (wp eval), check each product on its own. Developers: define( 'DS_UPDATES_BATCH', false ); in wp-config.php turns this off on a site, so every product is checked with its own request.
To check right away, open Dashboard → Home and click Check for updates at the bottom of the page, next to the version number. It checks the theme and every Dirigible plugin, then shows the result in place of the link: Up to date, or a count of available updates with a link to the Updates screen. Only administrators see this link.
You can also run the same check from Dashboard → Updates: click Check for Dirigible updates under the Last checked line. WordPress's own Check again link may skip Dirigible products checked in the last hour; this button always checks them all. If it finds updates, the page reloads so they appear in the Plugins and Themes lists, ready to install.
To check many sites at once, for example right after a release, run this snippet on each site (ManageWP Code Snippets, or wp eval over SSH):
if (function_exists('ds_check_dirigible_updates_now')) { print_r(ds_check_dirigible_updates_now()); }
It checks the same products as the Check for updates link (from ManageWP in one request, from wp eval one product at a time) and prints what it found: the products checked, updates available, any that couldn't be checked, and any without a license. It doesn't install anything. New versions then show up in ManageWP and under Dashboard → Updates straight away, and sites with automatic updates on install them on their next background update run.
Only one check runs at a time. If the site is already checking (its own twice-daily check, a ManageWP sync or someone else's click), you see A check is already running. Try again in a minute. and nothing is sent twice. The check that's running may cover only some products, so click again once it has finished to check them all.