Others

Fix Adaptive Card Template Not Iterating in SharePoint Visual Studio

Adam DavisAdam Davis Oct 22, 2026 868 views

Question details

The Adaptive Card template renders correctly in the designer but fails to iterate through sample data in a SharePoint Framework extension.

How to Fix Adaptive Card Template Not Iterating in SharePoint Visual Studio
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.
Before you start

Ensure your SharePoint Framework (SPFx) development environment is up to date and that you have the correct schema version defined for your Adaptive Cards.

Solution 1Recommended

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.

1
Check your SPFx version

Open your package.json file and verify the installed version of the SharePoint Adaptive Card extension base.

2
Verify template structure

Ensure your template is placed in the expected Quick View source file and follows the supported structure for your specific SPFx version.

3
Review the schema

Confirm that the Adaptive Card schema version declared in your template payload supports templating (v1.2 or higher is typically required).

Verify Adaptive Card and SPFx Version Support
Developer Support: If the issue persists, post your complete code and schema version to the Microsoft Q&A developer community for advanced troubleshooting.
Free Microsoft Office alternative

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. 1. Download the installer: Visit the official WPS Office website and download the free version for your operating system.
  2. 2. Install the software: Run the installer and follow the quick on-screen instructions to set up WPS Office.
  3. 3. Open your files: Launch WPS Office and instantly open your existing Microsoft Office files without any formatting loss.
Fully compatible with Microsoft Word, Excel, and PowerPoint formats.Lightweight installation that runs smoothly on most devices.Familiar user interface with no steep learning curve.Free to use with built-in PDF editing capabilities.
QA img-9

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.