Update Module

Audience: Low-code Engineers

Skill Prerequisites: Actions, Tokens

Changes the settings of a DNN module that's already on a page: its title, display options, visibility dates and permissions. Only the parameters you fill in are changed. Everything else stays as it is.

note

This action is part of the Portal Management add-on, which is installed and licensed separately (feature package PORTAL). If it isn't licensed, the action fails with a not-licensed error.

Typical Use Cases

• Rename a module, for example to match a customer name
• Hide a module after a date, or show it only during a campaign
• Change which roles can view or edit a module
• Save changes made in a form that was filled with Load Module

Don't use it to

• Change an HTML module's content. Use Update HTML Module instead.
• Move a module to another pane or page. The action can't change the pane. Add the module where you want it with Add Existing Module, then remove the old instance.
• Change a page's settings. Use Update Page instead.

Related Actions

Action Name	Description
Load Module	Reads the same settings into tokens.
Add Module	Adds a new module to a page.
Add Existing Module	Adds a shared instance or a copy of a module to a page.
Update HTML Module	Changes the content of an HTML module.
Import Module Content	Imports content into a module.
Update Page	Changes a page's settings.

Input Parameter Reference

Parameter	Description	Supports Tokens	Default	Required
Page	The page that has the module. Pick a page, or use an expression that resolves to a Tab ID, a Tab Path such as //Customers//Acme, or a Tab Name (the first page with that name is used). Leave empty to use the current page.	Yes	Current page	No
Module Identifier	The module to update, as a module ID or a module title. A title is matched without regard to case, and the first module on the page with that title is used. Deleted modules are skipped.	Yes	empty string	Yes
Module Title	The new module title. Leave empty to keep the current title.	Yes	empty string	No
Display Container	An expression evaluated as a boolean, for example true or [ShowTitle]. Sets the module's DNN Display Title option. Leave empty to keep the current value.	Yes (expression)	empty string	No
Enable Print	An expression evaluated as a boolean. Shows or hides the module's print option. Leave empty to keep the current value.	Yes (expression)	empty string	No
Enable RSS	An expression evaluated as a boolean. Turns the module's syndication (RSS) option on or off. Leave empty to keep the current value.	Yes (expression)	empty string	No
Start Date	The date the module becomes visible, for example 2026-10-01. Leave empty, or use a value that isn't a date, to keep the current value.	Yes	empty string	No
End Date	The date the module stops being visible. Leave empty, or use a value that isn't a date, to keep the current value.	Yes	empty string	No
Permissions	Rows of Permission Key and Role List. The key is VIEW or EDIT. The role list is role IDs or role names, separated by commas, semicolons or new lines, for example Registered Users;Editors. Use All Users or -1 for everyone and Unauthenticated Users or -3 for anonymous visitors. If you link to a Permission Grid field, you can use [PermissionGrid:PermissionName] tokens.	Yes (role list)	none	No

Output Parameters Reference

This action doesn't produce any output tokens.

Permissions

Each row replaces that permission on the module. Permissions without a row aren't changed.

• A VIEW row removes all existing view entries, stops the module from inheriting the page's view permission ("same as page"), and grants view to the listed roles.
• An EDIT row removes all existing edit entries and grants edit to the listed roles.
• Existing entries for single users and denied entries of that kind are removed too.
• Keys other than VIEW and EDIT (or their permission names) are ignored. Roles that can't be found are skipped without an error.

Considerations

• A missing module isn't an error. If the page or module can't be found, the action does nothing. Use Load Module first if you need to know.
• Use the module ID when you can. Titles aren't unique, so a title can match a different module than you expect.
• Clearing a value isn't possible. Empty parameters mean "keep the current value", so you can't remove a title or a start or end date with this action.
• Invalid booleans are ignored. If a boolean expression can't be evaluated, that setting isn't changed and no error is shown.
• Shared modules change everywhere. If the module is shared on other pages (see Add Existing Module), settings that belong to the module, such as permissions and dates, change on every page that shows it.
• Guard against an empty identifier. An empty Module Identifier matches the first module on the page that has no title. Add a condition such as [ModuleId] != "".
• Tab IDs are used as given. A numeric Page value isn't checked against the current portal. Make sure the ID comes from a trusted source.
• Leaving Page empty needs a current page. In a scheduled workflow or an API call there's no current page, so the action fails with Could not get current page.
• There's no permission check in the action. Anyone who can run it can change any module's settings and permissions. Only run it where trusted users can reach it.

Examples

tip

To understand how to use the below examples, please see Running Examples.

1. Rename a module and show its title

This action renames the module in [ModuleId] on the page in [PageId] to the value of [NewTitle] and turns on its title display.

{
    "Title": "Update Module",
    "ActionType": "UpdateModule",
    "Description": "Rename the module",
    "Condition": "[NewTitle] != \"\"",
    "Parameters": {
        "PageId": "[PageId]",
        "ModuleId": "[ModuleId]",
        "Title": "[NewTitle]",
        "DisplayContainer": "true"
    }
}

2. Hide a module after a date

This action sets an end date on the module titled Early Bird Offer on the //Events page, so it stops showing after 2026-12-31.

{
    "Title": "Update Module",
    "ActionType": "UpdateModule",
    "Description": "End the early bird offer",
    "Parameters": {
        "PageId": "//Events",
        "ModuleId": "Early Bird Offer",
        "DateEnd": "2026-12-31"
    }
}

Revised 09/27/2026