Troubleshooting Guide

1. Check your DNS settings for both your primary domain and any mapped domains. The A Records should match exactly.

2. Ensure that you have configured your mapped domain as an Alias Domain or Addon Domain in your server configuration settings (cPanel, etc).

3. Double check your mapping settings in the Domain Mapping System plugin settings area.

1. Ensure you have a supported hosting company that offers alias domains that do not redirect.

2. Clear cache at all levels, including Server, Website, CDN, and Browser, and then open the website in an incognito window to test if the issue persists.

3. Ensure you have an SSL certificate set up properly for all domains. Run a test by accessing your site via "http" and "https" independently in the URL bar. Sometimes the SSL certificate may not be configured properly, causing a redirect when using the secure version, and perhaps not when using the insecure version. Contact your hosting provider for assistance with SSL for alias domains.

4. Ensure you have the default .htaccess WordPress configuration, so the .htaccess file is not forcing redirects.

5. Attempt to rename the index.php file to see if it's causing undesired redirects.

1. Ensure that your domain is set up as an Alias Domain.

2. Ensure that your WordPress platform, all plugins, and all themes are updated to their latest versions.

3. Ensure there is not a second website installation for your mapped domain and delete any "extra" directories specifically set up for any mapped domains. All domains should be rooted to the primary site's WordPress installation. Be careful not to delete the primary website folder, and always ensure you have a full backup before deleting anything.

4. Contact your hosting company to check if the configuration settings are setup properly for your mapped Domain. Ask them: "I want to ensure that my Alias or Addon Domain is properly rooted to my primary domain website folder. Is there anything that would be preventing this from happening on my server?"

1. Reverting to the default WordPress configuration can resolve many issues.
1. Take a full backup of your website.
2. Attempt to deactivate all other plugins except Domain Mapping System and activate a default WordPress theme. If you're mapping to Products or a post type generated by another plugin, keep WooCommerce or that plugin activated.
3. Some plugins or themes may leave .htaccess configuration settings. Try to revert your .htaccess file to the to the default WordPress .htaccess content.
4. If you've used previous versions of Domain Mapping System, select the option to "Delete plugin, data, and settings (full removal) when uninstalling." and then fully delete the plugin from your site. Install the latest free version or paid version from your Account area (this portal can be accessed using the original email address used for purchase) and set up your mapped pages again. This will ensure data stored in some previous database entries utilized by the plugin are not causing issues.
5. Clear your cache at all levels and check if the issue persists in an incognito window.

2. If the issue persists, open a support ticket by following the steps at the end of this guide.

3. If the issue is resolved:
1. Reactivate each plugin one by one, clearing the cache after each activation and running a test each time. Activate your theme and any plugins it requires at the end of the process. Following this process will indicate which plugin or theme is causing the conflict.
2. Open a ticket by the following the steps below and inform us about which plugin or theme is causing the conflict. We'll see what we can do to get it resolved. Usually, there are a few possible options:
• We can release a fix in our plugin, or
• Contact the other development team behind the conflicting theme or plugin to see if they can release a fix, or
• In rare situations, we can suggest another plugin or theme to use. However, this should not be necessary, and in most cases there is a workaround solution of some kind. It is our goal to reduce these conflicts with the proper code so you can use any combination of plugins and themes you want.

Be sure to provide the following information:

• The primary domain of your site.

• A full list of alias domains you wish to map to your site.

• Explain your goal(s) as clearly as possible. What should each mapped domain display?

• Share simple instructions on how to reproduce any issues you're experiencing on the site so our team can repeat the procedure as quickly as possible.

• To clearly indicate the issues you're experiencing, share all error messages you see, capture screenshots of the issue, or record your screen in an explanatory video. Any "visual evidence" you can provide will help us "see what you're seeing."

• If possible, in order to ensure you're capturing all possible errors, activate debugging by replacing the line of code: define( 'WP_DEBUG', false ); in your wp-config.php file with these two lines, which will display errors on the frontend of your site:

plain text
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_DISPLAY', true );

• Your hosting provider.

• WordPress Version.

• Plugin Version.

• PHP Version.

• A link to share temporary login access or WP-Admin Administrator-level credentials (required).

• FTP login details (required).

• If requested, provide a full backup of your site and database so we can implement it locally and run our own testing.

We cannot be held responsible for any issues resulting from sharing website access, so be sure to take a full backup of your website and database before providing any access to your site. Website access or backup data you provide is only used by our support team or development team, if necessary, to diagnose support issues. Security is our #1 priority and we do not store information anywhere outside of our ticket system. Website backups are fully deleted after resolution or closure of a ticket and all other data can be deleted immediately upon request.