Themeisle Docs

Appearance

multiple-pages-generator

Limited by one project? MPG Pro lets you create unlimited projects, unlimited pages, and gives you priority support.

See Pro Plans →

MPG Troubleshooting Guide ​

This guide contains common queries that may help you work with MPG. For more information about the MPG plugin, please refer to the main documentation.

General requirements ​

  • Make sure you are using the latest version of the plugin.
  • If you are using a direct link to the source file, make sure that you share your Google Sheet before using that link. Sometimes, unwanted characters at the end of the link cause an error message stating “Datatable is not defined.”
  • Make sure the headers in the source file do not contain any brackets like {{title}}, {{mpg_title}}, [[title]]. Also, there is no need to include the prefix “mpg” in front of the header, as it is automatically added by our plugin. Avoid using header names that contain spaces or the underscore “_” character.
  • When replacing or migrating a data source (for example, switching from an Excel file to a Google Sheets link), make sure the new source has the same column headers, column count, and column order as the original. A mismatch between the old and new column structure is the most common cause of “DataTables warning: Requested unknown parameter” errors. After replacing the source, click Fetch and use to reload the data into your project.

Common issues and solutions ​

A project cannot be saved / URLs disappear from the project ​

Please navigate to the Advanced Settings page within the MPG plugin settings and click the Update Table Structure button, as shown in this screenshot:

MPG Update Table Structure

Where can I find the generated pages? ​

MPG-generated pages are virtual pages, not directly accessible on your Dashboard/editor, so you won't find them under the pages section like normal pages or posts. You can access them through the URLs generated in the MPG Project. More details can be found here.

Update the content of existing pages ​

To update existing pages, make changes in your source file and click the Fetch and use button in the Project settings.

How to get the source files of the pre-built projects ​

  • Create the project first, then open it.
  • Go to the source accordion and click the Download button next to the file to download a CSV file. 📝 Note: If the download button doesn’t work, access the source file from the "mpg-uploads" folder within the wp-content folder of your WordPress installation.

Please refer to our dedicated guide.

Use Rankmath/Yoast SEO with MPG ​

You can use an SEO plugin like Rankmath or Yoast SEO with MPG. To generate meta titles and descriptions for MPG pages, edit your template page and add MPG shortcodes like {{mpg_COLUMN-NAME}} under the meta title and description fields, as shown in this screenshot:

Rankmath SEO with MPG

While using SEO plugins, make sure the template page is not marked as "no index" to prevent all generated pages from being indexed.

DataTables warnings on data import/migration ​

If you see a browser warning similar to “DataTables warning: Requested unknown parameter ‘X’ for row N, column N” after importing or migrating your data source, this means the column headers in the new source file do not match what MPG has cached from the previous source.

Common causes:

  • Switching from one file type to another (for example, Excel to Google Sheets) without keeping the same column names and order.
  • Renaming, adding, or removing columns in the source file without refreshing the project.
  • Extra whitespace or special characters in header names that make them appear identical but differ internally.

How to fix it:

  1. Open your data source (Google Sheet or Excel file) and compare the column headers to those listed in the MPG project settings.
  2. Make sure the column names, column count, and column order in the new source exactly match the original.
  3. Correct any mismatched or renamed headers in the source file.
  4. In the MPG project settings, click Fetch and use to reload the updated data.
  5. After fetching, preview one of the generated pages to confirm the warning is gone.

Generated pages give a 404 error ​

We have a dedicated guide to debug this issue, which you can find here.

Caching plugin conflicts ​

Caching plugins sometimes purge or delete files from the wp-content/mpg-uploads/ directory. These files contain index data that MPG needs to serve generated pages. When caching removes them, pages that were previously working may start returning 404 errors.

Symptoms:

  • MPG pages return 404 errors after a caching operation (full-site purge, scheduled cleanup, or plugin update).
  • The errors disappear temporarily when the MPG project is saved or re-fetched, then return after the next cache purge.
  • 404 errors affect multiple projects at once rather than individual pages.

How to fix it:

  1. Open your caching plugin settings (for example, WP Rocket, W3 Total Cache, LiteSpeed Cache, or WP Super Cache). Note that the exact menu location and option names vary between plugins — consult your caching plugin's documentation if you are unsure where to find these settings.
  2. Find the file or directory exclusion settings for cache purge or cleanup rules.
  3. Add wp-content/mpg-uploads/ to the exclusion list so the caching plugin does not delete files in that folder.
  4. Save the settings and perform a manual cache purge.
  5. Visit one of the affected MPG pages to confirm it loads correctly.

⚠️ Important: The exact location of the exclusion setting varies by caching plugin. Look for options labeled Never cache the following pages, Excluded files, or Purge exclusions. Consult your caching plugin's documentation if you cannot locate this setting.

Generated URLs redirect to the homepage ​

  • Ensure no redirection plugins are active in your dashboard.
  • Check that generated URLs don’t contain special characters.
  • If using page builder plugins, try the page builder compatibility options available under MPG > Advanced settings. Refer to this screenshot:

MPG Page Builder Compatibility

Sitemap not generated ​

We have a dedicated guide for creating a sitemap that you can check here. If issues persist, check the WordPress base path settings under MPG Advanced Settings. See this screenshot for reference:

MPG WordPress Base Path Settings

MPG pages not indexed ​

It's important to understand that search engines manage the indexing process, which involves various factors beyond the direct control of our plugin. While our plugin facilitates the creation of SEO-friendly pages and sitemaps, the final indexing relies on search engines like Google.

📝 Note: If you still need help, feel free to contact our support team - pro users/free users.