Mentionly - Brand Monitor Template


Mentionly - Brand Monitor Template is a no code template for brand monitoring whereby the user signs up and is then prompted to set up their first brand to monitor. You can either monitor your own brand or a competitors (all segmented in the dashboard). It searches all the mentions on the resources that you have mentioned similar to the service Mention . All the data is being shown in the dashboard. Whenever you are choosing a mention in the dashboard, it will show you the posts that the brand is mentioned in.

It then performs a check and finds that brands social media accounts and by default will ignore mentions of the brand from those social networks (Facebook, Twitter etc) to prevent false positives as it will only to track other people’s mentioning the brand.


  • Login/Signup page
  • Dashboard
  • Admin panel
  • Stripe Subscription Integration
  • Responsive Design
  • Rankur and Clearbit API integration

Data Structure


First name, Last name, Full name and Image are responsible for holding user identity related information. Plan holds the info about Current User subscription plan. Trial end means registration date/time plus seven days. Whenever a new account is created, current day/time is registered and this user automatically gets a Free Plan subscription which will be canceled seven days past registration date. Every user will have his own list of Brands and Competitors. Whenever a user first registers his Onboarding Stage is name. This triggers the first step of the registration. After completion of the first step, create brand is triggered. A user has to add a brand otherwise he won't be able to get past create brand step. Whenever he completes both steps, Onboarding Stage becomes over and this popup will never appear again. An agency plan user has the possibility to create a Client. If isClient is turned yes, it means that this user is an agency's Client. Agency owner is the creator of this agency. A client is limited in his actions and can't add brands or competitors, he can just observe data. Company data field holds info about the agency that created the Client. Ultimately, accessRights field value determines whether you're an admin or not.

Source type

This data type will provide users with potential sources from they can extract mentions about the selected brand. It has fields that pull the source name and icon.


Users can subscribe to a set of plans that are predefined in the template. A plan is defined by name, description, planPicture and its Price. Plan data type has fields that describe its characteristics like Brand Allowance and Competitor Allowance , fields that indicate restrictions regarding the number of brands or competitors a user can monitor. Refresh Rate updates the mentions in your inbox either hourly or daily. Using data fieldstripeID we connect the plan from stripe with the one from the database. Mention History Allowance determines the amount of time your mentions will be stored in the database.


Messages data type will store all the messages users send to admin. It has two fields, one responsible for the content: body , and one responsible for the state of the message yes/no - read.


This data type refers to a specific Brand. Source is where the mention has been found. Link is the URL where the mention was found. ID is a mention identifier returned by Rankur API. Source Favicon is the icon of the resource where the mention was found. Read is a boolean data field that marks a mention either read or unread. Mentioned Date stores the day of the post creation that contains the mention.


Language data type has two fields, one is code that is responsible for sending the code of the language to Rankur. The other field is name that sets the name of the chosen language.


Logs data type has only one field that is called action, its role is to store user activity regarding subscriptions and show it into the admin panel.


A brand is characterized by Name, Logo, Link . Twitter Handle, Linkedin page and Facebook ID contains brands handles. Search Sources is a list of Source Types among which Rankur API will search for Mentions.Search ID is a field where unique ID's of a certain object from Rankur API are recorded, so that you can use it for future editing.

Track FB Profile, Track LinkedIn Profile, Track Twitter Profile and Track Brand Domain are boolean fields that indicate if these social networks are included or not in the search filters. Languages is a list that offers the user the possibility to filter the results that are retrieved through Rankur API. Competitor is a boolean field that helps create a competitor using Brand's data field without creating a separate object for Competitor brands. Team is a list of users who have access to observe mentions of the current brand.

Track Blogs, Track Brand Domain, Track Twitter Profile, Track FB Profile, Track Forums, Track LinkedIn Profile, Track News, Track Self, Track Social are boolean type fields which are used to select where to track the Brand identity using the Rankur API Some delays may apply depending on the API request calls.


This template has 4 pages.


The login and signup options are included on one page. You can switch to the needed one by clicking the link underneath the login/start 7 day trial button.


Once you signup, you will be redirected to the dashboard, where you will see a window that's going to offer you 2 choices. Those choices will be to add a brand or a competitor. You won't be able to get pass this window unless you complete one option.The dashboard displays all the data that is related to the brands that you select as your brands, and the brands that you select as being the competitors. You can see relevant information about them in the left side panel that offers you 4 menus. The first menu called unread mentions will offer you all the mentions that you haven't yet checked. Whenever you open a mention it changes its status to read. If a mention becomes read, it will move either in the social mentions or web & forum mentions board according to the type of mention. You can access them later if you want to.The managed brand/competitor board allows you to view the full list of brands/competitors that you are currently observing. You can also either delete them or pause monitoring.


The admin panel contains within itself 4 tabs with different information regarding the template. User menu contains all the users that registered on this platform. Here you can sort them according to the plans or send them an email. In the second tab you have the ability to view current as well as add new plans to the platform that users can subscribe to. Messages tab offers you the possibility to read users inquiries. Logs menu delivers a summary about the number of users per type of plan. It also shows you whether a user subscribed to another plan.


The page is designed as an error page when a user tries to reach an unavailable page .

Things to Note

External API

This template uses ClearBit Service (clearbit.com), a clear bit api key (free tier and scaling to the number of calls is needed) , Stripe API for payments and a Stripe key is required. The platform makes use of the Rankur monitoring service (rankur.com/) so a Rankur key from them is needed, API availability is on the upper tier price (https://rankur.com/plans-pricing.html).

During setup or adding a brand later they enter the brand name, which then does a data pull using Clearbit to pull through a list of brand/company names and logos so they can choose from a nice list and Rankur to monitor the mentions for the Brand.

Note: Additional API fees may apply depending on the requests made to respective services (Clearbit / Rankur). Check Rankur and Clearbit sites for pricing.

The mentions which the application is requesting from the Rankur are being filtered on the application side in order to minimize the daily API requests in order to preserve available numbers per account. These filter constraints can be customized to another method as needed for the application.

Warning popup (for Rankur service)

To disable the warning popup, please switch the "Rankur_rights" variable from no to yes.

Document image

Press the pen sign and change value from "no" to "yes"


This template uses the default Stripe plugin, as the main payment gateway for subscription based workflows when users subscribe to a plan.

[See the documentation on how to set Stripe Payments in Bubble App.]

More on Stripe subscriptions: https://stripe.com/docs/billing/subscriptions/overview

The Stripe Create Plan API call is designed to create a Plan from Admin dashboard. Details about the call: https://stripe.com/docs/api/plans/create

Admin panel

The admin panel access is granted to users who have the accessRights field value admin which determines whether you're an admin or not.

Document image

Release Notes

Update: 14 Oct 2021

  • Fixed the "Delete" button on dashboard page (responsible for deleting a brand)

Demo to preview the template