Checklist to Resolve the Issue in Kentico Xperience 13 (ASP.NET Core)
1. Register the Page Builder Middleware
Ensure you have this in your Startup.cs:
app.UseKentico();
app.UseStaticFiles();
app.UseRouting();
app.UseAuthorization();
app.UseEndpoints(endpoints =>
{
endpoints.MapControllerRoute("default", "{controller=Home}/{action=Index}/{id?}");
endpoints.MapRazorPages();
});
// Must be after UseRouting and before UseEndpoints
app.UsePageBuilder();
2. Enable Page Builder in Startup.cs
Also in ConfigureServices:
services.AddPageBuilder();
3. Register Page Templates
If you're using page templates (e.g., in App_Start or module registration):
[assembly: RegisterPageTemplate("Template.Identifier", "Template Display Name", typeof(YourTemplatePropertiesModel), "~/Views/PageTemplates/YourTemplate.cshtml")]
4. Check for Missing Permissions or Roles
Ensure your user has the necessary roles/permissions to create/edit pages using templates.
5. Verify the Template Exists
Make sure the physical .cshtml file exists at the path specified in the page template registration.
6. Ensure Page Builder Feature is Enabled in Kentico Admin
Go to Modules > Page Builder and confirm the feature is installed and enabled.
7. Rebuild and Restart
After adding all necessary configurations, rebuild the solution and restart the site.
8. 🔥 Most Important: Run the Live Site
Kentico Xperience only fully initializes Page Builder templates after the live site has been visited at least once.