Fix Adaptive Card Template Not Iterating in SharePoint Visual Studio
Question details
The Adaptive Card template renders correctly in the designer but fails to iterate through sample data in a SharePoint Framework extension.

- Product
- SharePoint Visual Studio
- Device & OS
- not provided
- Scenario
- Developing a SharePoint Framework extension using Adaptive Cards and templating syntax.
- Observed behavior
- The template does not iterate through sample data, and Visual Studio reports that the $data property is not allowed.
Ensure your SharePoint Framework (SPFx) development environment is up to date and that you have the correct schema version defined for your Adaptive Cards.
Verify Adaptive Card and SPFx Version Support
Check if your current SharePoint Framework extension and Adaptive Cards version support the $data templating property.
The error often occurs because the Adaptive Card designer uses a newer SDK than the rendering engine embedded in your SharePoint Framework version. Verifying version compatibility is the first step to resolving the property error.
Open your package.json file and verify the installed version of the SharePoint Adaptive Card extension base.
Ensure your template is placed in the expected Quick View source file and follows the supported structure for your specific SPFx version.
Confirm that the Adaptive Card schema version declared in your template payload supports templating (v1.2 or higher is typically required).

Looking for a Lightweight Office Suite?
While SharePoint development requires specific Microsoft tools, your everyday document needs don't have to be complicated. Try WPS Office for a seamless, free, and highly compatible alternative to Microsoft Office for creating documents, spreadsheets, and presentations.
- 1. Download the installer: Visit the official WPS Office website and download the free version for your operating system.
- 2. Install the software: Run the installer and follow the quick on-screen instructions to set up WPS Office.
- 3. Open your files: Launch WPS Office and instantly open your existing Microsoft Office files without any formatting loss.

Frequently Asked Questions
Why does the Adaptive Card designer work but SPFx fails?
The online Adaptive Card designer often uses the latest templating SDK, whereas your SharePoint Framework (SPFx) environment might be using an older rendering engine that does not yet fully support the $data property.
What schema version is required for Adaptive Card templating?
Adaptive Card templating is generally supported starting from schema version 1.2, but you must ensure that your host application (like SharePoint) also supports the specific templating SDK version being used.
Where can I get advanced help for SharePoint Framework development?
For complex development issues, it is recommended to post your questions, along with code snippets and schema versions, on the official Microsoft Q&A developer community forums.




