NAV Development Preview – December Update

Welcome to our update for the Developer Preview; the December update. As usual, we've fixed a lot of issues reported by you, for more information view the list of fixed issues, In addition to that we're announcing the following changes as you can see listed below. To jump directly to an updated image go to the Azure Gallery sign up at

The AL Formatter

The AL Language Visual Studio Code extension now offers the option of automatically formatting your source code. The auto-formatter can be invoked to format an entire AL document or a pre-selected range.

  • In an existing project, open the document that you want to format, right-click inside the document, and then choose Format Document.
  • To format a range, open the document that you want to modify, select the specific range to format, right-click it, and then choose Format Selection.

Show My Code 

The manifest has a new setting: Show My Code. It specifies if the source code must be visible when other extensions debug it.  

For example, an amazing library is developed and shared on AppSource for other people to use, but the author doesn't want the users to see the code when they try to debug into it from their extension. The author sets the ShowMyCode setting to make sure that the code is not shown when the user tries to debug into it. By default ShowMyCode is false but can be overriden in the app.json file to true.

Pages and Reports Show up in Search in the Web Client

For pages and reports, a new property called UsageCategory specifies how the object will appear in search results. It has the following values:

  • None
  • Lists
  • Tasks
  • ReportsAndAnalysis
  • Documents
  • History
  • Administration

If UsageCategory is set to None, the page or report will not appear in search results.

Two other properties are added if UsageCategory is set: ApplicationArea and AccessByPermission. These properties control if a page or report is visible to the user and can be opened if it does appear in a search.


page 70050088 SimpleCustomerCard


PageType = Card;

SourceTable = Customer;

UsageCategory = Documents;







field("No.";"No.") {}

field(Name;Name) {}

field(Address;Address) {}





As usual we encourage you to let us know how you like working with these additions and keep submitting suggestions and bugs. You can see all the filed bugs on our GitHub issues list ( To get an updated image jump directly to the Azure Gallery signup at

For a list of our previous blog posts, see the links at the end of this post.


Our earlier blog posts:

NAV Development Tools Preview - November Update

NAV Development Tools Preview - October Update

NAV Development Tools Preview - September Update

NAV Development Tools Preview - August Update

NAV Development Tools Preview - July Update

NAV Development Tools Preview - June Update

NAV Development Tools Preview - April Update

NAV Development Tools Preview - March Update

NAV Development Tools Preview - February Update

NAV Development Tools Preview - January Update

Announcing the Preview of Modern Development Tools for Dynamics NAV

Comments (14)

  1. So this is, in reality, the same as what was shipped with NAV2018? Format commands are in the extension for VSCode shipped with NAV2018 and UsageCategory is in NAV2018.

    1. Dan Kinsella says:

      UsageCategory doesn’t seem to work in the NAV 2018 release, although the property is available.

      1. UsageCategory doesn’t work for me in December Update.

      2. Dan Kinsella says:

        Seems it’s working fine for W1 but not GB, also the In Client Designer isn’t available in GB.

    2. Stanislaw Stempin says:

      Hi Erik, This is not exactly the NAV 2018 build but the bits are very close. When it comes specifically to Modern Dev the features are the same in these releases.

      1. Bartosz Porzezinski says:

        Will you be updating Modern Dev (via CU updates) that is part of NAV 2018 along with Development Tools Previews?

        1. Stanislaw Stempin says:

          We will follow the regular process in that CUs will only contain critical hot fixes. The new functionality added in each monthly Dev Preview update will then become available in the next on-premise release NAV 2018 R2.

          1. David Machanick says:

            Why not add them to the CU? Gives people more incentive to stay up to date.

          2. Salva Gimeno says:

            What is going to happen with the extension available in the Marketplace?

            Will it also be updated just with hot fixes until NAV2018R2 is released?

          3. Stanislaw Stempin says:

            The Marketplace extension is targeted towards use with the Dynamics 365 Cloud Sandboxes.
            Please see the FAQ:

    3. Alex Lang says:

      UsageCategory doesn’t have impact to the WebClient as well to the WindowsClient in NAV 2018 RTM. I agree with Dan.

      1. Alex Lang says:

        I’ve retried it -> and it seems it really works! Even in Windows Client. Great :))

Skip to main content