How to manage domains and companies in Flook

Flook offers powerful and flexible options for managing where your widgets, such as popups, tooltips, banners, and callouts, are displayed. To ensure a smooth experience, it’s important to understand how Flook handles  domains and companies and how to use them effectively.

Intended Usage: Managing Domains with Companies

In Flook, each  Company represents a group of domains related to a single site or application. These domains could represent different environments for the same site, such as productionstaging, and development.

For example:

  • Production: <a href="http://www.mysite.com/">www.mysite.com</a>
  • Staging: <a href="http://stage.mysite.com/">stage.mysite.com</a>
  • Development: <a href="http://dev.mysite.com/">dev.mysite.com</a>
The idea is that these domains are  alternatives of each other but serve the same core site. All widgets created within a Company will be shared across the defined domains for that site, providing a unified way to manage and target users across environments.
How to Set Up Domains:
  1. Go to Settings > Company.
  2. Add all relevant alternative domains for that Company (e.g., your production, stage, and dev environments).
  3. Configure your widgets to appear across any of these domains as needed.
This structure helps keep your widget management clean and organized for a single site and allows you to easily test features across different environments before going live.

Using One Company for Multiple, Unrelated Sites

While Flook is designed to have a single Company manage a group of alternative domains for one site, some users may choose to configure multiple, unrelated sites under a single Company. While this is technically possible, there are trade-offs involved.

Pros of Using One Company for Multiple Sites
  • Shared Monthly Active Users (MAUs) Across Multiple Sites: All of your sites will share the same MAU quota, potentially helping you optimize your usage under one billing plan. If one site has lower traffic, the remaining MAUs can be used for other sites, maximizing value for your plan.

Cons of Using One Company for Multiple Sites
  • No Ringfenced Widget Management: Managing widgets becomes less organized when multiple, unrelated sites are under one Company. There’s no clear boundary between widgets for different sites, which can lead to confusion when modifying or tracking changes.
  • Single Billing Structure: Since Flook links MAUs to a single Company, all unrelated sites within that Company will share the same billing plan. This means you can’t separate costs by site or charge different departments/clients independently.
  • Potential Conflicts in Element Matching: Flook’s widgets target specific elements on a page using CSS selectors and other matching logic. If your different sites share common HTML structures or element IDs, you might face conflicts where widgets display incorrectly or overlap across sites.
  • Difficulty in Targeting Users Across Different Databases/Systems: User targeting in Flook relies on unique identifiers (UUIDs) to match users to specific behaviors. If you’re running multiple unrelated sites, user data will come from different databases or systems, making it harder to maintain accurate and actionable user segments.
  • Reporting Challenges: Flook’s analytics and reporting are designed to provide insights for widgets across the domains within a Company. When using multiple, unrelated sites under one Company, it becomes challenging to isolate metrics for each site, which could skew the overall understanding of user engagement.

Recommendations for Best Practice

For the most efficient and clean management of your widgets and user experiences, we recommend creating a separate company for each unrelated site or product. This allows you to:

  • Maintain organized widget management per site.
  • Ensure clean separation of user tracking and reporting.
  • Manage billing and MAUs specifically for each domain.

If your sites are related or are different environments of the same site, you can comfortably group them under a single company. However, for completely unrelated websites, setting up separate companies within Flook will make it easier to manage your widgets, users, and billing independently.


By following these guidelines, you can ensure that Flook's powerful widget capabilities are used to their full potential, delivering the right experience to the right users while maintaining clarity and control over your management and billing processes.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us