Upgrading
Updating WP Job Portal keeps your jobs, companies, resumes and settings. This page lists what to do before you update and what changes on your site afterwards, release by release.
Before you upgrade
Section titled “Before you upgrade”- Back up your database and your files, including the uploads folder where WP Job Portal keeps logos and resumes (
wp-content/uploads/wpjobportaldataby default). - Check the requirements.
- If you use Pro or a suite, have your licence key from your account at wpjobportal.com ready.
Update WP Job Portal
Section titled “Update WP Job Portal”Update the free plugin as usual, from Dashboard → Updates or the Plugins screen. The database changes run by themselves.
If a migration cannot finish, a notice says WP Job Portal could not complete a database migration. Existing data was left in place. Select View System Status to see which step failed, under Migration history.
Then update Pro and the suites from Licences → Licences and add-ons or Dashboard → Updates. From 2.8.0, the free plugin needs Pro and the suites at version 1.1.0 or later. Until they are updated, a notice says Please update your WP Job Portal add-ons. and lists them.
What changes with 2.8.0
Section titled “What changes with 2.8.0”2.8.0 redesigned the admin and changed several things you may notice straight away:
| What | What to do |
|---|---|
| The admin menu is regrouped, with one Approvals page for everything that waits for you. | Nothing. See the dashboard. |
| Resume files are private. Direct links to files in the uploads folder stop working; files are downloaded through permission-checked links. Existing files are protected by themselves after the update. | On an nginx server, add the rule in How resume files are protected. |
| The shared Google Maps key is removed. Maps stay hidden until you add your own key. | Add your key, or switch to OpenStreetMap. See Maps. |
| Hiring status is separate from approval. The job statuses become Open, On hold and Closed. Jobs on Interviewing, Finalists Identified or Pending Approval move to Open. | Check Settings → Job attributes → Job status. See Hiring statuses. |
| A job needs a city or a remote workplace when it is saved. Existing jobs without a city show No location in the jobs list. | Add a city, or set Workplace Type to Remote, the next time you edit them. |
| Deleting the plugin keeps your data, unless you turn on Delete All Data When The Plugin Is Deleted. | Nothing. See Installation. |
| The salary currency moves from the Monetization tab to Jobs → Salary, and the privacy retention days from System status to System & Site → Privacy Retention. | Nothing; your values are kept. |
| Translations install themselves from wpjobportal.com. | If you changed the wording in your own translation file, see Change the wording. |
What changes with 2.9.0
Section titled “What changes with 2.9.0”2.9.0 is the AI update.
- AI has its own menu, WP Job Portal → AI. Choose an engine there: a Zywrap account, or your own Anthropic or OpenAI key. See AI settings.
- A Zywrap key saved before 2.9.0 moves to encrypted storage by itself the first time it is used.
2.8.1 and 2.9.0 also fix security issues. All sites should update.
Upgrading from 2.6 or earlier
Section titled “Upgrading from 2.6 or earlier”WP Job Portal 2.7.0 replaced thirty-seven separate add-ons with four products: Pro, Marketplace Suite, Recruit Suite and Matching Suite. Twelve former add-ons are now part of the free plugin. Your data stays where it is; these steps move each feature to its new home cleanly.
Before you update, go to Plugins and note which WP Job Portal add-ons are active. Their folders start with wp-job-portal-.
Where each former add-on went
Section titled “Where each former add-on went”| Now part of | Former add-ons |
|---|---|
| WP Job Portal (free) | All Companies, Copy Job, Cron Job, Job Alert (weekly), Job Listing Enhancer, Print (basic), RSS Feedback, Shortlist, Social Share, Tag, Tell a Friend, Widgets |
| Pro | Address Data, Advanced Resume Builder, All Resumes, Cover Letter, Departments, Elegant Design, Export, Folder, Message, Multi Resume, PDF, Reports, Resume Search, Visitor Apply Job |
| Marketplace Suite | Credits, Featured Company, Featured Job, Feature Resume, Multi Company, Visitor Can Add Job |
| Recruit Suite | Resume Action |
| Matching Suite | AI Job Search, AI Resume Search, AI Suggested Jobs, AI Suggested Resumes, Smart Matching |
Job alerts are free at weekly frequency. Daily, monthly and instant alerts, and the job alert admin tools, come with Pro. Print is free in its basic form; print templates come with Pro.
1. Install your products
Section titled “1. Install your products”Open Licences → Licences and add-ons from the WP Job Portal side menu, activate your licence key and install the products it covers. See Install Pro and the suites.
2. Switch off the old add-ons
Section titled “2. Switch off the old add-ons”An old add-on that is still active keeps running the feature exactly as before. The free plugin and each product leave a feature alone while its old add-on is active, so nothing runs twice. For example, Recruit Suite leaves resume actions and ratings to the old Resume Action add-on, and Matching Suite leaves each AI search, suggestion or match-score feature to its old AI or Smart Matching add-on; the rest of each product runs as normal. When you deactivate the old add-on, the new product takes the feature over.
- Go to Plugins.
- Deactivate the old add-ons whose features are now in the free plugin or in a product you have installed.
- Check the feature still works on your site.
Settings the old add-on used are kept when you deactivate it. For example, switching off the old Address Data add-on no longer resets the city setting the company form relies on.
3. Delete the old add-ons
Section titled “3. Delete the old add-ons”Once an old add-on is deactivated, you can delete it from Plugins. Older add-ons drop their database tables when deleted; WP Job Portal stops that for any table the free plugin or another product still reads.
4. Choose a mode
Section titled “4. Choose a mode”Upgraded sites run in existing-site compatibility: nothing is hidden and no setting is locked. When you are ready, go to WP Job Portal → Settings → Site mode and choose Careers & ATS or Job Marketplace. See Setup wizard.
5. Check sign-up and pages
Section titled “5. Check sign-up and pages”- Account Sign-Up is new in 2.7.0. Existing sites keep following WordPress’s Anyone can register until you change it under Settings → System & Site → Registration & Login.
- Your jobs page keeps its address, so job and company links shared before the update still open.
6. Check System Status
Section titled “6. Check System Status”Open WP Job Portal → Site health → System status and look for warnings. Older sites may be offered an InnoDB conversion for the plugin’s tables. Back up the database before you start it.