Create your first feature

What's a feature?

A feature is an entity that Bucket uses to roll out features, analyze adoption and satisfaction, and manage permissions. A feature is used to create and manage feature flags, targeting rules, engagement metrics, automatically collect feedback, and turn feature permissions on/off.

Getting started

• Navigate to Features and click the New feature button

• Give your feature a name

• If you haven't already, set up a Bucket SDK for your language and framework. Find the supported languages here.

Get your feature key

A feature key is automatically generated when you name the feature. You'll use this key to refer to the feature in your code.

You can change the feature key while creating the feature, but you cannot change it after it has been created.

The feature key allows you to determine if a feature is enabled for specific customers and to track customers' usage of the feature.

Example

If you're using React and have created a feature called Huddle, it will look like the following:

import { useFeature } from "@bucketco/react-sdk";

function StartHuddleButton() {
  const { isLoading, isEnabled, track } = useFeature("huddle");

  if (isLoading) {
    return <Loading />;
  }

  if (!isEnabled) {
    return null;
  }

  return <Button onClick={() => track()} />;
}

The track function will generate a huddle event. This is automatically sent to Bucket whenever a user uses the features.

Modify event tracking

By default, Bucket will look for events with the feature key to track usage.

You can change this to another event. To send a different event, you will expose a more generic track function:

import { useFeature } from "@bucketco/react-sdk";

function StartHuddleButton() {
  const { isLoading, isEnabled } = useFeature("huddle");
  const track = useTrack();

  if (isLoading) {
    return <Loading />;
  }

  if (!isEnabled) {
    return null;
  }

  // send a custom event, in this case using the "Object/Action" terminology
  // by using the `track` function from `useTrack` and send along
  // some custom attributes along.
  return (
    <Button onClick={() => track("Huddle Started", {type: "voice"})}>
      Start voice huddle!
    </Button>
  );
}

It's also possible to use company attributes to indicate feature usage instead of events. See the usage configuration documentation to learn how to customize usage tracking.

See the supported languages/frameworks documentation to learn how to quickly get started with a Bucket SDK or API

Next steps

• Dive into Targeting to roll out features gradually or to certain segments or environments

• Customize your usage tracking configuration to integrate with existing tracking solutions

• Learn about analysis to discover how the STARS framework and automated feedback surveys let you evaluate feature adoption and satisfaction

• Manage features from the Bucket UI or with an API