Overview
The CML Panel dashboard widget allows you to add text and CML (Cogniss Markup Language) to your app home screen or home page, transforming static content into engaging, individualized experiences.
When enabled, you can use the CML Panel widget’s rich text editor to present dynamic, personalized content to your users that automatically updates based on their engagement with your app.
📌 This widget is available for both mobile and web applications.
Step 1: Add the CML Panel widget to your Dashboard
1. In Cogniss Creator, navigate to Dashboard in the left sidebar.
2. Click on Add new widget in the top right of the page.
3. In the Dashboard widgets library, search for the CML Panel widget and click Add. Return to the Dashboard by clicking on the cross in the top right.
4. The CML Panel widget will now be on your Dashboard and ready for you to configure as needed.
5. Click Save Changes at the bottom of the page.
Step 2: Configure your CML Panel
You can use the CML Panel widget to create different types of personalized experiences for your app users.
Note, for mobile only you can select your preferred text alignment from:
Left align for standard left-aligned text
Center align for centered content presentation
User Display Name
A popular use of the CML Panel widget is to display the user's name on your app home screen or home page.
1. In the CML Panel widget, write your greeting followed by {{user.displayName}}.
2. Once you have updated the widget, click Save Changes at the bottom of the page.
3. Open your app to preview your CML Panel widget and to test that it works as expected.
💡 You can customize headings and content blocks throughout your app by using {{user.displayName}} to create a more engaging and personalized user experience.
Progress Charts
You can use the CML Panel widget to allow your users to see their journey with your app through dynamic progress visualizations that track improvement over time. For detailed instructions on setting up progress charts in your app, see the Progress Charts Overview article.
1. Once you have configured your chart you can copy the chart CML and add it to your CML Panel widget.
2. Once you have updated the widget, click Save Changes at the bottom of the page.
3. Open your app to preview your CML Panel widget and to test that it works as expected.
Previous Activity Scores and Responses
You can use the CML Panel widget to keep your users engaged by showing past results or responses, encouraging continued participation with app activities. You can:
Display recent quiz scores or assessment results
Show the previous set goal
Highlight improvements and achievements over time
If you would like to use the CML Panel dashboard widget for this purpose we recommend that you review the Creating Conditional CML article in the first instance to learn more about the possibilities with using conditional CML in your app.
💡 You can add a second CML Panel widget to your dashboard by clicking on the vertical ellipsis in the top right of the CML Panel and clicking on Add another. A second CML Panel widget will appear in your Dashboard. At present, a maximum of two CML Panel widgets can be added to the Dashboard.
