Exercise Smartwords

Exercise Smartwords allow you to use variables within your content to make the exercise more flexible to changes. They enable updates or alterations to content with a single adjustment, making it practical for live updates and multi-context use.

When to Use

  • When content isn't finalized and may need adjustments (e.g., re-tweeting a live tweet from a Player).

  • To apply the same exercise across various contexts, such as different countries or different user scenarios.

  • To allow Facilitators to modify content dynamically in response to Player actions during an exercise.

How to Set It Up

  1. Navigate to Configuration > Exercise > Smartwords to access the Smartword library.

  2. Create a new Smartword by adding an "index," which identifies the Smartword in your exercise.

  3. Assign a "value" to the index, which will be the content shown when the Smartword is used.

  4. For bulk additions, use the CSV import feature.

  5. Organise Smartwords into folders for easier management.

  6. Ensure that the Smartwords library or the exercise is published to activate the Smartwords.

Smartword Library

How to Use in Exercises

  1. When building your exercise, incorporate Smartwords using the format {data.index}.

  • Example: {data.company} or {data.issue}, where "company" and "issue" are indices defined in the Smartwords library.

  1. Note that there is no automatic validation—ensure that each Smartword corresponds to a valid index in your library.

What the Player Sees

The player isn't aware that a smartword has been used. Players only see the published content with the smartword index replaced with the value.

Tips & Best Practices

There's no valiadation of smartwords so be sure to test everything publishes as expected.

  • Group Smartwords into folders for organized management and easy access.

  • Before launching an exercise, test Smartwords to ensure they correspond correctly to the indices.

  • Use short, descriptive index names for clarity.

Last updated

Was this helpful?