SuiteCommerce SMT Error: CMS Record Invalid

When adding or editing a content block in SuiteCommerce Site Management Tools (SMT), you may encounter a “CMS Record Invalid” error when attempting to save. This prevents the SMT content from being saved to the page.

This guide explains what caused the error in one SuiteCommerce environment and walks through the steps used to resolve it.

Screenshot of error:

Actual text of error(s):

This error is usually also accompanied by the error “Unable to save content”

What Causes the “CMS Record Invalid” Error in SuiteCommerce?

There may be many causes of this error, but in our case, it was a result of the CMS content type referencing an old CMS custom record. This was due to the environment previously having a SuiteCommerce instance installed and a new one being installed after a period of not using the previous instance so the SMT core content bundle did not fully replace the custom record references by the content types.

For SMT tools, the CMS content is controlled via “content types” as well as “content records”.  Each CMS content section is saved as a custom record under the custom record that the CMS content type is referencing. Therefore, the content type needs to reference the correct content record in order to work properly.

How to Fix the SuiteCommerce SMT “CMS Record Invalid” Error

To resolve this issue, complete the following steps:

Step 1: Check for Duplicate or Missing CMS Custom Records

1. Go to “Customization > Lists, Records, & Fields > Record Types”
2. Make sure to show inactive records.

3. When sorted by record name, scroll to where all the CMS records are, they should be grouped together (see image)

   

4. Take note of any that have a “(2)” next to them as highlighted in the image above.

Step 2: Check Which Custom Records the CMS Content Types Reference

1. Go to “Commerce > Content Management > CMS Content Types”
2. Click “edit” on any of the CMS content types that are giving the ‘invalid’ error when editing in SMT tools

3. Look at the value in the “custom record” field.

   1. If that content type has a duplicate custom record from step 1, and the value in the content type is NOT the second content record, change it to match the second content type.

   2. 

   

4. Click “save”

Step 3: Save the Changes and Test Site Management Tools

Click “save”

Attempt to create the SMT content on the website, you should now be able to save it.

Still Unable to Save Content in SuiteCommerce SMT?

If you are unable to save a CMS content type through SMT tools on a SuiteCommerce website, find out if the environment previously had a SuiteCommerce website installed, if so, the issue could be an incorrect reference on the content type to the CMS custom record. Changing the custom record reference on the content type should resolve the issue.