Installation Troubleshooting – WS Form

Installation Troubleshooting

WS Form is designed to work with without requiring any additional software or configuration to WordPress.

If your WordPress hosting is not configured properly, you might receive the error message ‘Whoops!¬†Something went wrong.’ when you first use the plugin.

This occurs when WS Form is unable to access the WordPress REST API system. This will not only cause problems with WS Form but may cause other plugins or WordPress features to fail.

Here are some reasons for this error:

Hosting Security Settings

Some hosting providers include security software that is designed to protect your website from hackers. Whilst this is definitely a good thing, sometimes that software can be incorrectly configured and cause requests to the WordPress API to fail.

Read our 403 Forbidden Error Message knowledge base article to learn more.

REST API Restricted to Authenticated Users or Disabled

You may have a plugin installed that is restricting or disabling access to the WordPress REST API such as:

  • Disable REST API – You should whitelist the ws-form/v1 namespace in ‘Settings’ for this plugin.
  • Clearfy – Set ‘Remove REST API Links’ to ‘Off’ in the ‘Performance’ tab.

WS Form uses the namespace ws-form/v1. You should ensure this namespace is whitelisted for the WordPress REST API if your blocking plugin allows this.

Permalinks Incorrectly Configured

Your permalinks may not be configured correctly. ¬†WS Form supports ‘ugly’ and ‘pretty’ style permalinks.

Read the WordPress Permalinks help page for more information.

.htaccess File Misconfigured

Make sure that your .htaccess file is working correctly.

Read the WordPress htaccess help page for more information.

Web Server Misconfigured

Make sure your web server is configured properly and that it is not serving the default web server welcome page (e.g. Apache welcome page) when you trying to access your front page.

Refer to the WordPress installation help page for more information.

If you are still experiencing problems, please contact our support team.