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!¬†WordPress is not configured properly.’ 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:

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 are not configured correctly. Read the WordPress Permalinks help page for more information. WS Form supports ‘ugly’ and ‘pretty’ style permalinks.

.htaccess File Misconfigured

Make sure 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.