Show Listing And Continue Execution

Audience: Low-code Engineers

Skill Prerequisites: Actions, Listings, JSON

Shows a Listing module on the page, or opens it in a popup, then carries on with the next actions. Use it from a form or a listing to show a listing only when the user needs it.

It only works on listings with Display Mode set to In Popup or Manual. A popup listing opens in a popup. A manual listing appears on the page.

Action	What happens after the listing is shown
Show Listing And Stop Execution	No further actions run.
Show Listing And Continue Execution	The listing is shown right away and the next actions keep running.

Typical Use Cases

• Show search results and then filter them with Filter Listing
• Show one listing and hide another, for example to switch between two views of the data
• Open a listing in a popup and keep running actions, such as logging

Don't use it to

• Show a listing and stop. Use Show Listing And Stop Execution instead.
• Let the user pick a row and copy its values into a form. Use Pick Item from Listing instead.
• Open a form in a popup. Use Open Form Popup And Continue Execution instead.
• Show a listing from an API endpoint. It's not available there.

Related Actions

Action Name	Description
Show Listing And Stop Execution	Shows the listing the same way, then ends execution.
Hide Listing And Continue Execution	Hides the listing or closes its popup, and keeps running actions.
Filter Listing	Changes the filters, sorting or paging of a listing on the same page.
Refresh Listing	Reloads the data of a listing.
Open Form Popup And Continue Execution	Opens a Form module in a popup.

Input Parameter Reference

Parameter	Description	Supports Tokens	Default	Required
Select Module	The Listing module to show. Pick it from the list, or use a token or expression that gives the module ID or its GUID.	Yes	empty	Yes
Clear Listing QueryString	Removes the listing's page, search, filters and sorting from the URL, so the listing starts from its defaults.	No	false	No
Listing Modal Settings	Options for the popup, as a JSON object, for example {"backdrop":"static"}. Only used when the listing opens in a popup. See the modal options for Bootstrap 3 and Bootstrap 5.	Yes	empty	No

How it works

The action sends a small script to the browser as soon as it runs. Meanwhile, the server keeps running the next actions. The script checks the listing's Display Mode:

Display Mode	What happens
Initially Visible	Nothing. The listing is already on the page.
In Popup	The listing opens in a popup, with the Listing Modal Settings. The popup's width comes from the listing's Popup Width setting, or 75% if it's not set.
Manual	The listing appears on the page.

See Display Mode.

Considerations

• It's sent right away. The listing is shown while the next actions are still running. If a later action fails, the listing stays visible.
• Valid JSON only. If Listing Modal Settings isn't a valid JSON object, the action fails with Could not parse the Listing Modal Settings. Common options are backdrop (true, false or "static") and keyboard (false stops the Esc key from closing the popup).
• Clear Listing QueryString is broad. In the legacy listing views, it removes every URL parameter whose name contains the module ID, for example page1234. In the current views, it reloads the listing with no page, search, filters or sorting.
• Same page only. The listing must be on the page the user is looking at. If it isn't, nothing is shown and the browser console shows an error.
• The value must be a module. If Select Module isn't a number or a GUID, the action fails with Could not determine ModuleId to execute the action.
• Not in APIs, workflows or scheduled tasks. The action runs JavaScript in the browser, so it's only available in forms and listings.
• From JavaScript. You can do the same with dnnsf.api.actionGrid.showGridOrPopup(1234, {"backdrop":"static"}, false), where 1234 is the listing module ID.
• Conditions. To show the listing only in some cases, give it a condition, for example "[CustomerId]" != "". See Common Parameters.

Examples

tip

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

1. Show search results, then filter them

Add these two actions to the "Search" button of a form with a Status field. The first shows the Listing module 1234, which has Display Mode set to Manual, and keeps going. The second filters it by the status the user picked.

[
    {
        "Title": "Show Listing And Continue Execution",
        "ActionType": "ShowAGAndContinue",
        "Description": "Show the search results",
        "Parameters": {
            "ModuleId": "1234",
            "ClearGridQueryString": false
        }
    },
    {
        "Title": "Filter Listing",
        "ActionType": "FilterActionGrid",
        "Description": "Filter the results by status",
        "Parameters": {
            "ActionGridModule": "1234",
            "Filters": [
                {
                    "name": "Status",
                    "value": "[Status]"
                }
            ],
            "ReplaceFilters": true
        }
    }
]

Revised 09/27/2026