Skip to content

Docs

Install the theme and Perdita Core, add Perdita Pro, and manage your license.

Install the theme and Perdita Core

The theme

  1. Download the theme zip from the download page.
  2. In WordPress, go to Appearance, Themes, Add Theme, Upload Theme.
  3. Choose the zip, click Install Now, then Activate.
  4. Run the setup wizard from the notice, or open Appearance, Perdita.

Perdita Core

  1. On the Perdita screen, click Install Perdita Core, or download the zip from the download page.
  2. For the zip, go to Plugins, Add Plugin, Upload Plugin, then install and activate.
  3. Open Perdita in the admin menu and turn on the modules you want.

Add Perdita Pro

  1. Download the Pro zip from perdita.app/api/download/pro or your account. Pro is free during early access.
  2. In WordPress, go to Plugins, Add Plugin, Upload Plugin, then install and activate.
  3. Go to Perdita, Perdita Pro, then activate your license key.
  4. Turn on the Pro modules you want under Perdita, Modules. You choose which modules to turn on.
ModuleBefore you turn it on
SpeedWorks on its own. Turn on Perdita Core's free Caching module to get the most from Speed.
Image CompressionWorks on its own, on your own server.
Design/BuildWorks with the theme's hook points and the block editor.
SEO ProAdds to Perdita Core's free SEO module.
Forms ProAdds to Perdita Core's free Forms module.
Sales ProAdds to Perdita Core's free Sales module.
SecurityWorks without Perdita Core's Security module.
BackupsSends copies to any S3-compatible storage.
Spam ProtectionWorks on your forms and WordPress comments.
SMTP FailoverNeeds two or more SMTP routes.
Server-Side AnalyticsUses the consent choice from Perdita Core's free Analytics module.
SubscriptionsAdds a digest to Perdita Core's free subscriptions.
Link AssistantWorks in the post editor.
AI PlatformWorks with the theme's AI design tools.

Your license

  1. Sign in to your account with the email you bought with, and copy your key.
  2. In WordPress, go to Perdita, Perdita Pro, paste the key, and click Activate.
  3. To free a site, click Deactivate beside it on your account page.

A Single Site license covers one live site plus one staging site. Multi-Site covers 5 sites and Developer covers unlimited sites.

Roll back to an earlier version

The theme, Perdita Core, and Perdita Pro share one version number. Install the same version of all three.

  1. Turn off auto-updates for all three first, or WordPress puts the newest version back.
  2. Download the theme and Perdita Core from every release, and Pro from your account.
  3. Upload the theme under Appearance, Themes, Add Theme, Upload Theme, then choose Replace installed with uploaded.
  4. Upload each plugin under Plugins, Add Plugin, Upload Plugin, then choose Replace current with uploaded.

FAQ

What do I need?

WordPress 6.4 or later and PHP 8.0 or later. Perdita Core needs the Perdita theme or a Perdita child theme. Perdita Pro needs the theme and Perdita Core.

Will my design survive theme updates?

Yes. You'll find your design in the database, in one option named perdita_settings, outside the theme files. Put your own code in a child theme.

Does Perdita Core send data anywhere?

Only for update checks, from wp-admin, cron, or WP-CLI. Every module that talks to an outside service starts off, and you set it up with your own account: Google Analytics, PageSpeed Insights, Search Console, your SMTP server, Stripe, and your AI provider.

Can I try Pro without a license?

Yes. During early access, you can click Use the evaluation key on the Perdita Pro screen to turn on every Pro module. When we start charging, sites on the evaluation key go unlicensed within about a week.

How do I move a license to another site?

Sign in to your account, find the site under Active sites, and click Deactivate. Then activate the key on the new site. Sites on a local address (localhost, .test, .local) never need a key.

Something else? Email support@perdita.app.