Docs
Troubleshooting
Most problems have a quick fix. Find your message or symptom below.
Emails are not arriving
ClientCopy sends through WordPress's own email, and many hosts send it unreliably or put it in spam.
- Create a test project with your own email address as the client email, add an item, and click Email invite on the project page. If it arrives, sending works.
- If it does not, install a free SMTP plugin and connect it to a real mail account or an email service. This fixes the large majority of cases.
- Check the spam folder, and ask your client to do the same.
- Make sure the project has a valid Client email.
"The test email could not be sent" (ClientCopy Pro) or "The email could not be sent"
WordPress could not hand the message to your mail system. Set up SMTP as above, or ask your host to enable email.
Client links
"This link is not valid"
The link was replaced with New link, the project is archived, or the link was copied incompletely. Use Email invite or Copy to send a fresh one.
"Too many attempts. Please try again later."
ClientCopy allows 20 wrong link attempts per visitor in 15 minutes, which protects links from guessing. Wait a while and try again. If it keeps happening for ordinary visitors, your site is probably behind a proxy or CDN that makes everyone look like one visitor. See the Security notes in the plugin's readme.
The link opens my home page instead of the portal
Your site uses Plain permalinks and the link was made by an older version. Update to ClientCopy 1.1.3 or newer and send the new link (Copy on the project page), or switch Settings → Permalinks in WordPress to Post name.
My links stopped working after I changed my WordPress security keys
ClientCopy's protection is built from the salts in wp-config.php. After they change, click New link on each project and resend it. Saved credentials and the Pro license key also need to be entered again.
The portal page is blank or stuck on "Loading…"
- The portal needs JavaScript. Ask the client to try another browser.
- A security or optimisation plugin may be blocking or combining the portal's scripts. Exclude the ClientCopy portal address from it.
- If you use page caching or a CDN, exclude
/clientcopy/and/wp-json/clientcopy/from caching.
Uploads
"This file type is not allowed here."
Image items accept JPG, PNG, GIF and WebP only. File items accept images plus PDF, Word, Excel, PowerPoint, text, CSV, ZIP, MP4, MOV and MP3. See What clients can upload.
"The upload failed. The file may be too large."
The file is bigger than your server allows. Ask your host to raise upload_max_filesize and post_max_size, or ask the client to send a smaller file.
Approved but not written
If an item is approved but the content did not reach the page, you will see the reason. Fix it, then click Re-apply to site on the item.
| Message | What it means and what to do |
|---|---|
| The target is already published. Enable "Allow writing to published content" in settings, then use Re-apply. | ClientCopy protects live pages. Tick Allow writing to published content in Settings, or move the content by hand. |
| The target page or post no longer exists. | The page was deleted. Edit the item and choose another target. |
| You are not allowed to edit the target page. | Your WordPress user cannot edit that page. Approve while signed in as someone who can. |
| Could not set the featured image. | Check the uploaded file still exists in the Media Library and is an image. |
| Advanced Custom Fields is not active. | Activate ACF, or choose a different destination. |
| ACF did not save the value. Check the field key. | The field no longer exists or its key changed. Pick the field again. |
Pro license (the ClientCopy Pro add-on)
| Message | What it means and what to do |
|---|---|
| That does not look like a license key. | Paste the key exactly as emailed, without spaces. Letters, numbers, dashes and underscores only. |
| License key not found. Check it and try again. | A typo, or a key that belongs to a different mode (a test purchase cannot activate a live site). |
| This license is not active. It may have expired, been paused, or been refunded. | Check the subscription in your Dodo Payments receipt, renew it, or contact us. |
| This license has reached its activation limit. Deactivate it on another site first. | The key is already on 2 sites. Click Deactivate license on one of them. |
| That license key is for a different product, so it cannot unlock ClientCopy Pro. | Use the key from your ClientCopy purchase email. |
| Could not reach the licensing server. Check your internet connection and try again. | Your server cannot reach live.dodopayments.com. A firewall or hosting restriction on outgoing connections is the usual cause. Ask your host to allow it, then retry. |
| Could not reach the update server. Try again in a few minutes. | Your server could not reach this website to check for updates. Retry later, or download the latest zip. |
Pro switched itself off
ClientCopy re-checks the license daily. Pro turns off only when the license is clearly no longer valid, for example the subscription ended or was refunded. Renew and it recovers at the next check. A temporary network problem never turns Pro off.
Other questions
Do I need pretty permalinks?
No. Client links work with any permalink setting (version 1.1.3 or newer). Only a custom Portal path needs pretty permalinks.
Where is my data stored?
On your own site, in five database tables (cc_projects, cc_requests, cc_submissions, cc_activity_log, cc_templates with your database prefix) and your Media Library. Nothing is sent to us. See the Privacy Policy.
Can a client change something after I approved it?
No. An approved item is locked. Ask them to send the change by email, or edit the page yourself.
Webhooks, alerts and sign-off (ClientCopy Pro)
A webhook or alert was not sent
Open ClientCopy → Pro → Webhooks and alerts and look at Recent deliveries.
- Click Send test on the webhook. If the test fails, the message beside it says why (for example HTTP 404 or a connection error).
- The address must be a public
https://URL. Plain http, localhost, private network addresses and addresses with a login in them are refused. - Sending runs from WordPress's scheduled tasks (WP-Cron). On a very quiet site it can be a few minutes late, and some hosts turn WP-Cron off; ask your host to run
wp-cron.phpon a schedule if so. - Make sure the event you expect is ticked for that webhook, and that your license is active: with no active license, nothing is sent.
- Email alerts use your site's normal WordPress email, so see Emails are not arriving.
I cannot sign a project off
A project can be signed off once every item is approved (it shows Completed in the Team list) and only once. If you reopen an item and complete the project again, sign it off again.
Still stuck?
Email sudarshanhosalli90956@gmail.com. It helps a lot if you include:
- What you did and what you expected to happen.
- The exact message you saw, or a screenshot.
- Your ClientCopy version (Plugins page), WordPress version and PHP version (Tools → Site Health → Info).
- Whether you also use the ClientCopy Pro add-on, and its version.
Pro customers get support by email, and we usually reply within two business days.
Can't find what you need? Email sudarshanhosalli90956@gmail.com. Last updated 5 November 2026.