Available from v2026.1.LTS, the read-only configuration for Activities allows you to protect Activities in your Item bank from unwanted edits.

When enabled, you can:

• Render all Activities in read-only mode, or
• Render specific Activities in read-only mode based on attached Tags

Activities rendered in read-only mode cannot be edited. You can also optionally allow duplication of protected Activities so authors can create editable copies while preserving the original.

How It Works

The read-only behavior for Activities is controlled through the read_only initialization configuration for Activities in the Author API.

When the Activity-level read_only option is enabled:

• If no filter.either option is specified, all Activities in the Item bank are rendered in read-only mode.
• Authors cannot edit existing Activities.
• Authors cannot create new Activities.
• If filter.either is specified, only Activities matching the defined Tag criteria are rendered in read-only mode.
• Activities not matching the filter remain editable.

This configuration does not affect Item-level editability unless the Item-level read_only option is also configured separately.

Configuration

Enable Read-only for All Activities

If filter.either is not specified, all Activities in the Item bank will be rendered in read-only mode.

// Configuration to set all Activities in the Item bank to read-only
{
    "mode": "activity_list",
    "config": {
        "global": {
            "items": {
                "read_only": {
                    "enable": true
                 }
            }
        }
    }
}

Enable Read-only Based on Tags

You can limit read-only behavior to specific Activities by defining a filter.either option using Tags in Tagsv2 format.

When filter.either is defined:

• Only Activities that contain any of the specified Tags are rendered in read-only mode.
• All other Activities remain editable.
• Authors can create new Activities (unless restricted by other configuration).

{
    "mode": "activity_list",
    "config": {
        "global": {
            "items": {
                "read_only": {
                    "enable": true,
                    "filter": {
                        "either": [
                            {
                                "type": "activity_tag_type",
                                "name": "protected"
                            }
                        ]
                    }
                }
            }
        }
    }
}

Allowing Duplication of Read-only Activities

For Activities rendered in read-only mode based on Tag filtering, you can allow authors to duplicate them by enabling the filter.duplicate option.

This allows authors to:

• Keep the original Activity protected
• Work on a new editable copy

When duplication is enabled and an Activity is duplicated:

• The Author API automatically removes any Tag specified in filter.either from the duplicated Activity.
• The duplicated Activity becomes editable.

This ensures:

• The original Activity remains protected.
• The new copy can be safely modified without affecting the source.