Troubleshooting
Last updated
Staff Archive Page Not Showing
- Go to Staff > Settings, open the Staff tab, and leave Disable Archive Page unchecked. Click Save Changes.
- The archive slug comes from Plural Label. Our Team gives
/our-team/. - Switch to a default WordPress theme to see whether the theme is involved.
Contact Form Emails Not Being Received
- Confirm the staff member has an Email in Staff Details.
- Send WordPress mail through your provider, for example with WP Mail SMTP.
- Check the recipient’s spam folder.
- Set From Address under Staff > Settings, on the Advanced tab, to an address your mail provider accepts.
CAPTCHA Not Working
- Under Staff > Settings, on the Advanced tab, check Enable captcha on message form and fill in Recaptcha site key and Recaptcha secret key. Captcha runs only when all three are set.
- The form uses Google reCAPTCHA v3. Use v3 keys, not v2.
- Register the site domain in the reCAPTCHA admin console.
“Please refresh the page and try again”
The page was served with the contact form script from before CP Staff 1.2.2. Purge your page cache and any CDN cache after updating.
“Messaging is not available”
Check Staff contact modal on the Advanced tab and click Save Changes.
Static Staff Lists
[cp_staff_list static="true"] leaves out the card links and the email and phone icons.
Department and Staff Order
Departments on the archive are ordered by name.
Staff are ordered by Order, then by name.
- Open the Staff list.
- Click Quick Edit for the staff member, set Order, then click Update.
Rate Limiting
Enable staff contact form throttling is off until you check it. Max submissions per day from same user starts at 3.
- On the Advanced tab, raise Max submissions per day from same user. The choices are 2 through 10.
- The count resets on the next calendar day.
- People who share an IP address share that IP’s count. Each sender email has its own count.
Template Overrides Not Working
- The theme directory must be named
cp-staff. - Keep the same folders the plugin uses under
templates/. - Clear any page cache after you change a template.
- A theme copy of
parts/email-modal.phpneeds the hiddenstaff-idfield. See Template Overrides.
More help is at Getting Help.
Using CP Staff?