About Profile Pages
This article provides an overview of Profile Pages and guides you on how to effectively use them in your Knack app.
What You'll Learn
You'll discover how to implement profile pages for user account management, create administrative tools that appear in the user menu, and configure profile pages for different user roles—adding essential self-service functionality that enhances the user experience while reducing administrative overhead.
What are Profile pages?
A profile page serves as a hub for managing administrative tasks related to the user. It offers convenient features such as displaying the membership details of a logged-in user or allowing them to easily update their account information through a user-friendly form.
Common scenarios where profile pages prove beneficial include:
- Account Settings: A dedicated profile page for when users needs to update their account information such as their name or change their password.
- Admin Control Panel: A page where system administrators can work on user management, system logs, and other admin-related tasks.
- Data Export Pages: Dedicated pages for bulk data exports, such as exporting data to spreadsheets for reporting.
- Reporting & Analytics: profile pages used to run and display various reports, aggregated data, or key metrics, often used by management or specific user roles.
- Batch Data Management: Tools for admins or power users to delete records or perform other maintenance tasks across data tables.
- File Management: A page where admins or specific user roles can manage uploaded files, update file metadata, or download files stored in the system.
- Troubleshooting & Support: profile pages that offer troubleshooting tools, system health checks, or access to logs to help diagnose and fix issues in the system.
- Maintenance Mode Pages: profile pages for updating system messages or handling app-wide announcements.
Note: profile pages are only available after users are activated in your app.
Profile pages are not included in page menus. Instead, they have their own separate user menu in the top-right corner of the Live App:
Profile pages can be of the same page elements as standard pages, except for login pages.
Tip: For more information on standard pages, see our article here.
Where do I access Profile Pages?
To access your Profile pages in the Builder, simply click on "Pages" in the left menu. Within the page tree, you will find all of your profile pages listed under the "Profile Pages" section.
By clicking on any profile page in the tree, you can easily view and adjust its settings.
Here is an example of profile pages in the Customer Payment Portal app:
Managing profile Pages
Adding a profile Page
To add a profile page, simply click on the "+" icon located in the profile Pages section of the page tree:
Editing a profile Page
When you would like to edit a profile page, you can do so by selecting the drop-down arrow in either of the following locations:
*
Tip: To learn more about page settings, page rules, and embedding your app, see the following articles:
- Page Settings
- Using Page Rules
- Embedding Your App
Copying a profile Page
You have the option to copy any of the start profile pages in your page tree.
To copy a profile page, locate the profile page you wish to copy and click the drop-down arrow icon. From there, select the "Copy" option.
A new window will then appear, allowing you to provide a name for the duplicated profile page.
Note: All elements and child pages will also be copied.
Deleting a profile Page
To delete a profile page, simply click on the drop-down arrow icon and choose the "Delete" option. A confirmation prompt will appear asking you to confirm the deletion.
Building a profile Page
You have the flexibility to create as many start profile pages as you require by simply clicking on the "+" icon in the profile Pages section of the page tree.
A new window will appear, guiding you through the process of adding your profile page. During this process, you will be guided to choose the user roles that will have access to the profile page:
Every profile page you create will automatically be included in the user menu. The user menu is the convenient navigation menu that your users can access from the top-right corner of the Live App.
INSERT IMAGE PLACEHOLDER
Note: There is currently no available option for hiding profile pages from the user menu.
Passwords
If you choose to include a password field on an edit/update form, you have the option to customize the password input field and access special password actions that allow for greater control over how passwords are managed:
To access these settings, select the pen icon shown in the above image.
Require the logged-in user's current password: When enabled, this action requires that the user enters their current password in order to submit the form.
Update the password: When enabled, this action allows the user to update their password.
When you enable these actions, you have the flexibility to customize the label for each one. If you choose to enable both actions, the user will be required to provide both their current password and create a new password.
profile Page Settings
You have the flexibility to customize various options for a page in the "Settings" section.
To access page settings, simply select the "Settings" option from the drop-down arrow icon located next to the page's name in the page tree or at the top menu. Here, you will find a variety of customizable options for the page.
Tip: To learn more about page settings, see our article here.
Note: Page URLs must be in all lowercase and can only consist of alphanumeric characters.
Permissions
You have the option to make a profile page accessible to all users or only specific user roles. By selecting the "Give permission to all users" option, all users will have access to the profile page from the user menu.
If you choose the "Limit permissions to specific roles" option, you can then select which user roles should have access to the page from the user menu.
Page Rules
Page rules are a powerful feature that allows you to automate actions based on specific conditions as soon as a user enters a page.
For instance, suppose you wish to notify your members when their membership is nearing renewal. You can define a page rule to display a message to users, reminding them of their upcoming renewal based on the renewal date.
Tip: To learn more about page rules, see our article here.
Updated 8 days ago