Customize master pages [AX 2012]

Updated: April 28, 2014

Applies To: Microsoft Dynamics AX 2012 R3

The Microsoft Dynamics AX 2012 R2 Retail starter store is a site built by using the commerce runtime (CRT) and the new site authoring and publishing model in Microsoft SharePoint Server 2013. For more information, see Overview of the SharePoint 2013 page model. You can use the Retail starter store as a basis for developing your own online store. To customize the shared framing elements such as the header and footer for all the pages in your site, you can modify the site’s master pages.

This topic shows you how to customize a master page by updating the Welcome page of the starter store.

To update a master page

  1. Open a web browser and navigate to the Welcome page for the starter store. Typically, the URL for the Welcome page resembles the following:



    Observe the behavior of the page. A slide show cycles through three pictures representing product categories. At the top left-hand side of the page, you can see the Contoso logo.

  2. Open a web browser on a computer where you are logged in using the administrative account for SharePoint.

  3. Navigate to the Site Settings page of the store. Use port 40003 and sign in with administrative credentials. The link to the Site Settings page is typically found at a URL that resembles the following:



    Add this page to your Favorites to make it easy to return to it in the future.

  4. Click Master pages and page layouts in Web Designer Galleries to view a list of files in the Master Page Gallery page.

  5. Right-click a file that you want to edit, such as Storefront.master, and then click Check Out.

  6. Right-click the file and then click Download a Copy.

  7. Edit the file by using Visual Studio or another editor. For example, in the following code from Storefront.master, you can change the logo file that is displayed on each page. The file is named logo_Contoso_main.png. You can edit that file or replace the file name with the name of a file that contains a graphic of similar size to display your company logo. The following code shows the path and file name of the logo in the Storefront.master file:

    <div class="msax-Main">
                        <div class="s4-notdlg msax-LogoBar">
                            <div class="msax-Logo">
                                <a id="A1" href="<% $SPUrl:~sitecollection/ %>" runat="server">
                                    <img src="/_layouts/15/Images/Storefront/logo_Contoso_main.png" />
  8. To upload the file and add your changes to the site, click Upload Document on the Files ribbon.


    This procedure illustrates one way of changing master pages and page layouts for the online starter store. For more information about how to use Microsoft SharePoint Server 2013 to modify the visual site design, see Develop the site design in SharePoint 2013.

  9. Refresh the Welcome page in your initial browser session to see your changes.

Note Note

You can edit the master page files directly by mapping a network drive. For more information, see Map a network drive to the SharePoint 2013 files for online stores.

Announcements: To see known issues and recent fixes, use Issue search in Microsoft Dynamics Lifecycle Services (LCS).