web
You’re offline. This is a read only version of the page.
close
Skip to main content

Announcements

No record found.

News and Announcements icon
Community site session details

Community site session details

Session Id :
Small and medium business | Business Central, N...
Suggested Answer

How to run Custom First Page on Fresh Extension Installation in Business Central (On Cloud)

(0) ShareShare
ReportReport
Posted on by 2,116

I am developing an extension for Business Central (On Cloud) and want to display a specific setup page only when the extension is freshly installed. For subsequent runs, Business Central should behave as usual without showing the setup page again.

The main requirement is to guide users through the setup process during the initial installation of the add-on.

What I Have Tried

  • Install Codeunit:
    • Created an Install Codeunit but couldn't achieve the desired behavior.
  • Event Subscriber:
    • Tried subscribing to the OnRegisterManualSetup procedure in the Guided Experience Codeunit but didn't get the expected results.

Question

  • How can I ensure a custom setup page runs automatically when the extension is installed for the first time?
  • Are there specific events or a recommended approach to implement this functionality?

Any guidance or code samples would be greatly appreciated!

I have the same question (0)
  • Gerardo Rentería García Profile Picture
    26,842 Most Valuable Professional on at
  • Suggested answer
    Khushbu Rajvi. Profile Picture
    22,458 Super User 2026 Season 1 on at
    The primary setup feature is specifically designed for AppSource apps, but for Per Tenant Extensions, you can still provide Guided Experience items. Please go through the document that gdrenteria has shared. 

Under review

Thank you for your reply! To ensure a great experience for everyone, your content is awaiting approval by our Community Managers. Please check back later.

Helpful resources

Quick Links

Introducing the 2026 Season 1 community Super Users

Congratulations to our 2026 Super Stars!

Meet the Microsoft Dynamics 365 Contact Center Champions

We are thrilled to have these Champions in our Community!

Congratulations to the April Top 10 Community Leaders

These are the community rock stars!

Leaderboard > Small and medium business | Business Central, NAV, RMS

#1
OussamaSabbouh Profile Picture

OussamaSabbouh 2,024 Super User 2026 Season 1

#1
OussamaSabbouh Profile Picture

OussamaSabbouh 2,024 Super User 2026 Season 1

#3
YUN ZHU Profile Picture

YUN ZHU 1,383 Super User 2026 Season 1

Last 30 days Overall leaderboard

Featured topics

Microsoft Training Manuals

Product updates

Dynamics 365 release plans