Implement Hosted Saved Rows
Last updated
Was this helpful?
Last updated
Was this helpful?
This feature is available on Beefree SDK Core plan and above.
With Hosted Saved Rows, you can provide your end users with the option to save and manage reusable content directly within the builder. Hosted Saved Rows can be activated through a toggle within the Developer Console, which makes it an excellent option for those who are interested in a fast implementation of Saved Rows. Once you toggle this feature on, your end users will be able to save the rows they create within the builder, and reuse them easily in the future. They can also perform actions to manage the rows that they save, such as renaming them, deleting them, categorizing, or recategorizing them. This page covers the steps you need to take to successfully implement Hosted Saved Rows.
The following video tutorial discusses what Saved Rows are, how reusable content can support your end users throughout their content creation journeys, and how you can implement Hosted Saved Rows in your application.
To enable Hosted Saved Rows for your application, follow these steps:
Log in to the Developer Console.
Navigate to the application you'd like to configure Hosted Saved Rows for.
Click on Details.
Navigate to Application configuration and click View more.
Scroll to the Saved Rows section.
Toggle on the Hosted on the Beefree SDK Infrastructure option.
Read the pricing information in the popup closely, because additional fees may apply.*
If you'd like to proceed, confirm you read and understand the pricing to activate the feature.
Important: Keep in mind that charges apply for saved rows that are hosted not only in your production applications, but also for your development applications.
*Hosted Saved Rows have the following pricing structure:
Allotment
Not available
Not available
100 Hosted Rows
250 Hosted Rows
1000 Hosted Rows
Price for extra unit
$0.35/Hosted Rows
$0.25/Hosted Row
$0.20/Hosted Row
Note: Visit our Usage-based fees article to learn more about Hosted Saved Rows pricing.
Once you've successfully enabled Hosted Saved Rows in the Developer Console, you'll access the following:
Rows saved by your application's end users will be stored and hosted in the Beefree SDK storage option.
End users can save rows directly to the hosted infrastructure and retrieve them as needed.
Once you successfully enable Hosted Saved Rows within the Developer Console, your application's end users will have access to a new Save icon for each row, and other options for managing the rows they save.
The Hosted Saved Rows UI includes the following experience for end users:
End users can save a row using the Save icon.
They have the ability to name and categorize rows.
They can edit a row's name or category and save those changes.
End users can decide to reuse or delete rows through the Rows tab in the side panel.
They can also use the vertical three dots to add and manage categories.
Reference the Hosted Saved Rows end user documentation for more information on the end user steps and experience.
Hosted Saved Rows includes advanced permissions to control how rows and categories are accessed and managed. These permissions allow you to define user capabilities, such as editing or deleting rows.
The permissions you can control for Hosted Saved Rows through Advanced Permissions are the following:
canDeleteHostedRow: Allows or prevents deleting hosted rows.
canEditHostedRow: Enables or disables editing of hosted rows.
canManageHostedRowCategory: Controls whether end users can manage row categories.
canAddHostedRowCategory: Determines if end users can add new categories.
Keep the following behaviors in mind when setting advanced permissions:
If both canDeleteHostedRow and canEditHostedRow are set to false, the row menu will be hidden.
If both canManageHostedRowCategory and canAddHostedRowCategory are set to false, the category management menu will be hidden.
The following configuration displays an example of the rows object inside of advancedPermissions:
Once Saved Rows is enabled globally in the Developer Console, you can disable it for specific users using the saveRows parameter in the beeConfig document. This lets you control access based on subscription plans, feature purchases, or beta testing.
Take the following step to disable access for specific users:
Set saveRows to false for users who shouldn’t have access.
The following code provides a simple example of how to add the saveRows configuration parameter and set it to false to make the feature unavailable to select users.
The following image shows the save icon when the end user clicks on the row.
The following image does not show the save icon when the end user clicks on the row. This behavior occurs after adding saveRows to your beeConfig and setting it to false.
Similar to how you may want to restrict which end users can save rows based on subscription type, plan type, and so on, you can also control which users have access to the ROWS tab within the builder altogether. By default, the ROWS tab is available within the builder.
You can remove the ROWS tab by:
Add the defaultTabsOrder parameter to your beeConfig and set it to: ['content', 'settings'] or ['settings', 'content'].
Note: The only difference between these two options is the order in which they will appear in the builder.
Keep in mind the defaultTabsOrder is a string array (string[]).
The tab order represented in the snippet below with content first and settings second, results in the visualization displayed in the image after.
In the following image, the ROWS tab is no longer available to the end user. In the following image, the ROWS tab is no longer available to the end user and the order of the tabs are Content first and Settings second.
The tab order represented in the snippet below with settings first and content second, results in the visualization displayed in the image after.
In the following image, the ROWS tab is no longer available to the end user and the order of the tabs are Settings first and Content second.
Reference the Hosted Saved Rows Webinar to learn more about other customizations that are compatible with Hosted Saved Rows. The webinar discusses the following topics:
How to enable Hosted Saved Rows
How to use Advanced Permissions with Hosted Saved Rows
How to restrict which end users can save rows
How to customize the modals related to Hosted Saved Rows
How to use Hosted Saved Rows with Content Services API
Reference the sample code in this GitHub repository to follow along with the webinar tutorial.
Visit the Hosted Saved Rows page to also learn more about the following topics:
