The Home Page

The home page is the first page seen by your users when they log in or visit the app directly.

The home page is the first page seen by your users when they log in or visit the app directly.

The home page is dynamic, which means it can be different for different users depending on visibility rules.

In practice, it is the highest page in the sidebar that the current user has permission to see. For example, if there are three pages

  • Page A (Only visible to Admins)

  • Page B

  • Page C

When an Admin logs in, they will see Page A When a non-admin logs in, they will first see Page B

This allows you to control the experience your users see depending on their role, or their stage as user.

Setting Up Role-Specific Homepages

To create different homepages for different user roles:

  1. Plan Your Homepage Structure: Decide what the first page should be for each user role

  2. Arrange Pages in Order: Drag pages in the sidebar to position role-specific pages at the top

  3. Set Visibility Rules: Configure page visibility so each role sees their intended homepage first

  4. Test Each Role: Use "View as user" to verify the correct homepage appears for each role

Example Setup

For a system with Admin, Manager, and User roles:

  1. Admin Dashboard (visible to: Admin only) - becomes homepage for Admins

  2. Manager Overview (visible to: Manager + Admin) - becomes homepage for Managers

  3. User Tasks (visible to: All users) - becomes homepage for regular Users

  4. Other pages below in the hierarchy

Troubleshooting Homepage Issues

Homepage Shows Wrong Page After Login

Common Causes:

  1. Hidden pages above your intended homepage - These still affect the homepage hierarchy

  2. Visibility rules not properly configured - User can see pages you didn't intend

  3. User role assignment issues - User doesn't have the expected role

  4. Publishing not complete - Changes haven't taken effect yet

Solutions:

  1. Check Hidden Pages: In build mode, look for greyed-out pages above your intended homepage

  2. Review Page Order: Drag your intended homepage to the very top, or set visibility rules appropriately

  3. Verify User Roles: Check the Users table to confirm role assignments

  4. Republish App: Go to Settings > Publishing > "Publish Changes"

Pages Missing After Onboarding

If essential pages like "My Profile & Preferences" don't appear after users complete onboarding:

  1. Check Conditional Filters:

    • Review custom visibility rules on these pages

    • Ensure rules don't depend on fields that might be empty after onboarding

    • Temporarily remove conditional filters to test

  2. Verify User Data Population:

    • Check that onboarding properly populates required user fields

    • Review any custom rules that depend on user field values

    • Test the complete onboarding flow using "View as user"

  3. Review Page Visibility Logic:

    • Ensure pages are visible to the user's assigned role

    • Check if pages are accidentally hidden from all users

    • Verify parent folder visibility if using page folders

Setting a Fixed Homepage for All Users

If you want the same homepage for everyone regardless of role:

  1. Create a Dashboard Page: Add a blank page or view as your intended homepage

  2. Move to Top Position: Drag this page to the very top of your sidebar

  3. Set Universal Visibility: Configure visibility as "All User types"

  4. Hide Role-Specific Pages: Move role-specific content to lower positions or separate folders

Advanced Homepage Scenarios

Different Homepages by User Properties

You can create dynamic homepages based on user properties (not just roles):

  1. Use Custom Visibility Rules: Create rules based on user field values

  2. Example: Homepage varies by department, location, or user status

  3. Setup: Create multiple "homepage" options with custom visibility conditions

  4. Test Thoroughly: Use "View as user" with different user property combinations

Homepage Redirection Based on Onboarding Status

For apps with onboarding flows:

  1. Onboarding Page: Set as homepage for users who haven't completed onboarding

  2. Main Dashboard: Set as homepage for users who have completed onboarding

  3. Custom Rule: Use a boolean field like "Onboarding Complete" to control visibility

  4. Seamless Transition: Users automatically see the main app after completing onboarding

FAQs

My home page is not the page I expect it to be

If the home page you're seeing is not the page you expect, it's likely that a page that is hidden from the sidebar is actually above the page you expect. To fix this, visit the homepage by clicking your logo, and then turn on Build Mode. If the page you're on is hidden from the sidebar, first unhide it and then drag it lower in the order of pages. Make sure it is beneath the page you want to be the home page.

How do I set up different homepages for Admins vs regular users?

  1. Create an "Admin Dashboard" page and set its visibility to "Internal Users only" or specific admin roles

  2. Create a "User Dashboard" page and set its visibility to "External Users only" or regular user roles

  3. Position the Admin Dashboard above the User Dashboard in the sidebar

  4. Admins will see the Admin Dashboard as their homepage, while regular users see the User Dashboard

Why don't new users see their expected homepage after completing onboarding?

This usually happens when:

  • The homepage has visibility rules that depend on user fields not populated during onboarding

  • The onboarding process doesn't properly set the user's role or required fields

  • There are conditional visibility rules that are too restrictive

Fix: Review the visibility conditions on your intended homepage and ensure all required user data is populated during the onboarding process.

Last updated

Was this helpful?