Create dynamic e-commerce pages based on URL parameters

Article
08/01/2024

This article describes how to set up a Microsoft Dynamics 365 Commerce e-commerce page that can serve dynamic content, based on URL parameters.

An e-commerce page can be configured to serve different content, based on a segment in the URL path. Therefore, the page is known as a dynamic page. The segment is used as a parameter to retrieve the page content. For example, a page that is created in site builder and named blog_viewer gets mapped to the URL https://fabrikam.com/blog. This page can then be used to show different content, based on the last segment in the URL path. For example, the last segment in the URL https://fabrikam.com/blog/article-1 is article-1.

You can also override a parameterized URL segment with a site builder page. For example, a page that is created in site builder and named blog_summary can be mapped to the URL https://fabrikam.com/blog/about-this-blog. When the https://fabrikam.com/blog URL is requested with the /about-this-blog segment on the end, the blog_summary page content is returned instead of the /about-this-blog segment being interpreted as a parameter to be used by the https://fabrikam.com/blog page.

When selecting names for the parameters to be passed to the dynamic page, the name of the dynamic page as it appears in the URL (/blog in the example above) can't be used as a parameter name or a substring of a parameter name.

Note

The functionality for hosting, retrieving, and showing dynamic page content is implemented by using a custom module. For more information, see Online channel extensibility.

Set up a dynamic e-commerce page

To set up a dynamic e-commerce page, you must create the dynamic page, create the base URL, and configure the route to the dynamic page.

Create the page that will serve dynamic content

To create a page that will serve dynamic content, follow the steps in Add a new site page. The page that you create will require implementation of a module that uses the last segment in the URL path to retrieve content from an external data source. For more information about custom module development, see Online channel extensibility.

Create the base URL for the dynamic page

To create the base URL for the dynamic page in Commerce site builder, follow these steps.

Go to URLs, and select New > New URL.
In the Create new URL dialog box, select Internal page. Under URL path, enter the path that will serve as the root for the dynamic page (in this example, /blog). Then select Next.
In the Select a page dialog box, select the page that you created to serve as the dynamic page, and then select Save.
Select Publish.

Configure the route to the dynamic page

To configure the route to the dynamic page in Commerce site builder, follow these steps.

Go to Site Settings > Extensions.
Under Parameterized URL paths, select Add, and then enter the URL path that you entered when you created the URL (in this example, /blog).
Select Save and publish.

After the route is configured, all requests to the parameterized URL path will return the page that is associated with that URL. If any requests contain an additional segment, the associated page will be returned, and the page content will be retrieved by using the segment as a parameter. For example, https://fabrikam.com/blog/article-1 will return the https://fabrikam.com/blog page displaying the content that it retrieved using the /article-1 parameter.

Override a parameterized URL with a custom page

To override a parameterized URL with a custom page in Commerce site builder, follow these steps.

Go to URLs, and select New > New URL.
In the Create new URL dialog box, select Internal page. Under URL path, enter the path that includes the segment to override (in this example, /blog/about-this-blog). Then select Next.
In the Select a page dialog box, select the custom page, and then select Save.
Select Publish.
If the custom page hasn't yet been published, go to Pages, select the custom page, and then select Publish.