Skip to content

Custom Widgets allow you to create unique and reusable UI components that extend beyond the standard widget offerings in FlutterFlow Studio. By leveraging Custom Widgets, you can achieve a higher level of customization and control over your app’s user interface.

In most cases, you can create a reusable component with the basic widget set available in FlutterFlow Studio. However, when you want to include a UI package from pub.dev, Custom Widgets are the better choice.

Key Use Cases

  • Unique UI Elements: Create complex UI components that are not available in the default FlutterFlow Studio widget set.

  • Third-Party Integrations: Integrate external UI packages from pub.dev to enhance the functionality and appearance of your app.

Creating a New Custom Widget

To create a new custom widget, add a new Custom Code snippet and follow the quick guide below. In this example, we will create a ProductRatingBar widget that uses a pub.dev dependency to display the rating bar UI. It will also take a callback action to provide the rating value back to the caller.

Properties: Width & Height

For custom widgets, it is mandatory to specify both width and height. These properties are required to size the custom widget appropriately. Without setting these dimensions, the custom widget will not render correctly within your application.

Add Dependency to Custom Widgets

In this example, we are using the flutter_rating_bar dependency to create a ProductRatingBar widget for our Product pages. See how we utilize the example code from pub.dev and add the customized widget in FlutterFlow Studio:

Using a Custom Widget

To add a custom widget to your page, you can drag and drop it from the Widget Palette’s Components section or through the Widget Tree section. Here is a demo:

Providing the Callback Actions

Since we created the onRating callback action in our custom widget, we must provide an action when setting the widget in page. In this example, we set the ratingValue to the page state variable userRating.

Preview Widget

FlutterFlow Studio also allows you to view your custom widget once it is successfully compiled.

The Preview widget tab of a StarRating custom widget, with Width 300 and Height 60 set as preview parameter values.The Preview widget tab of a StarRating custom widget, with Width 300 and Height 60 set as preview parameter values.

Last updated on