Skip Navigation
Expand
  • Advanced SearchOpens new dialog
    Enter plus (+) or minus (-) signs in search terms to make a word required or excluded
    Search Tips
    Filter by product
    Filter by category
Widget Error Upgrading Framework to 3.11
Answer ID 12965   |   Last Review Date 03/15/2025

Why is my stage from development to staging failing with an standard widget error?

Environment:

Custom/Standard Widgets
Customer Portal (CP)

Resolution:

The error you are encountering is caused from a Custom Widget directly setting the standard widgets version. The info.yml of your Custom Widgets will need to be checked to make sure the contains section has widgets that are supported in Framework version 3.11.
 

contains:
- widget: standard/search/KeywordText
 versions: ["1.0", "1.1"]

As noted above, the supported version for the KeywordText is 1.2; thus you will need to add this to all of your widgets that have this contains section in your info.yml.  Along with this, updating all other widgets to a supported version in this contains section will need to be done as well.
 
Cause:
The custom widget uses the contain file to pull in the widget version requested; this is then loaded with the framework causing incompatibility errors.  Thus a standard widget is on the "page" that is not supported in this version of the Customer Portal Framework.
 

Notes:

The error for this issue generally looks like the following.

error - template: 'standard.php' Contained widget standard/search/KeywordText does not have the correct declared version. The contained widget's version is '1.2'. It must be one of the following: 1.0, 1.1. Please upgrade the contained widget on the Widget Management page.