Common Issues

This page covers the problems NotedWP users run into most often, along with step-by-step fixes.

Overlay Not Appearing

If you navigate to your site and the NotedWP overlay does not show up, work through these checks in order.

  1. Confirm the ?noted parameter is in the URL. The overlay only loads when your URL includes ?noted or when a valid guest token is present. Regular visitors never see NotedWP scripts or UI.
  2. Check the visibility mode. Go to Noted > Settings and confirm the overlay visibility is not set to “Off” or a mode that hides the overlay for your role.
  3. Confirm your user has the noted_view_reviews capability. Go to your user profile (or check via a role-editing plugin) and ensure the noted_view_reviews capability is assigned. Without it, the overlay will not render even when the URL is correct.

Pins Not Showing

You can see the overlay, but some or all pins are missing.

  1. Select the correct breakpoint. Pins are tied to the breakpoint (desktop, tablet, mobile) they were placed on. Switch breakpoints in the overlay toolbar to find them.
  2. Verify you are on the correct page. Pins are page-specific. If you placed pins on /about/, they will not appear on /contact/.
  3. Check your status filter. The overlay lets you filter pins by status (open, resolved, etc.). Clear or adjust the filter to see all pins.

License Activation Fails

If you enter your license key and activation does not succeed, try the following.

  1. Check your internet connection. Your server needs outbound HTTPS access to reach the licensing server.
  2. Double-check the key. Copy and paste it directly from your purchase confirmation email to avoid typos or extra whitespace.
  3. Confirm you have not reached your activation limit. Each key supports a set number of sites. Deactivate an unused site first, or upgrade your plan for more slots. You can manage activations from your LemonSqueezy portal.

“Upgrade to Pro” Banner on Non-Homepage Pages

On the free tier, you may see an “Upgrade to Pro” banner when navigating to pages other than the homepage. This is expected behavior. The free plan limits overlay access to your homepage only. Upgrade to a paid plan to unlock overlay access on all pages.

Guest Cannot Access a Share Link

When a guest clicks a share link and sees an error instead of the overlay, check these items.

  1. Verify the share link is valid. Open NotedWP > Share Links and confirm the link exists.
  2. Check the expiration date. Share links can be set to expire. If the link has passed its expiration, generate a new one.
  3. Confirm the link has not been revoked. Revoking a link immediately disables it, even if it has not expired yet.
  4. Check the guest limit. The free plan allows up to 3 guest links. If you have reached the limit, revoke an unused link or upgrade your plan.

Export Fails

If exporting feedback to an external tool produces an error, follow these steps.

  1. Verify your integration credentials. Go to NotedWP > Integrations and confirm the API key or OAuth connection for your target tool is correct.
  2. Use the test connection button. Each integration includes a “Test Connection” button. Run it before attempting an export. If the test fails, re-enter your credentials or re-authorize the connection.

Notifications Not Sending

NotedWP can send email notifications for new feedback, status changes, and other events. If emails are not arriving, investigate these areas.

  1. Check your email settings. Open NotedWP > Settings > Notifications and confirm notifications are enabled for the events you expect.
  2. Verify wp_mail works on your server. Many hosting environments require an SMTP plugin (such as WP Mail SMTP or FluentSMTP) to send email reliably. Send a test email from your SMTP plugin to confirm delivery.
  3. Check the notification mode. NotedWP supports “instant” and “digest” modes. If you have selected digest mode, emails are batched and sent at the scheduled time, not immediately. Switch to instant mode if you need real-time alerts.

Still Stuck?

If none of the solutions above resolve your problem, visit the Getting Support page for instructions on contacting the NotedWP team.