Keep your team's feature flags up-to-date with fresh targeting rules and lists of users
Overview
- Targeting individual users for inclusion or exclusion (e.g., enable or disable a feature for user #123)
- Targeting all users who satisfy an attribute-based rule (e.g., enable a feature for all users located in Germany)
Why feature flagging should be based on the warehouse
- You can do more complex segmentation by leveraging all the data in your warehouse, including event data and third-party data. Your warehouse is the only place where all of this data coexists.
- You can keep your LaunchDarkly segments in sync with the rest of your business tools. For example, you might want to send an email newsletter to users who've been invited to a beta program. You also might want to sync these attributes to a CRM like Salesforce or HubSpot. Hightouch integrates with 100+ SaaS tools used for email marketing, customer support, sales, and more. Define your audience once and activate your data everywhere.
- You don't have to send any sensitive user data to LaunchDarkly. Hightouch determines which users are part of your segment and only transmits the bare minimum information necessary for targeting (usually just a user ID).
- Segments can be defined using the tools that your teams are most comfortable with. You can filter and transform data from your warehouse using SQL or our visual query builder—whichever you prefer. (You can even create LaunchDarkly segments based on work you've already done in dbt or Looker!)
Supported sync methods
- Target users for inclusion
- Target users for exclusion
- Target users who match a custom rule

Targeting users for inclusion or exclusion


Creating a new segment

- All lowercase
- No spaces. Use hyphens instead.
- Must be unique within your LaunchDarkly instance.

Targeting users who match a custom rule



Getting started
Step 1: Connect to LaunchDarkly
Create an API token
- Log in to LaunchDarkly
- Visit your Account settings page
- Click on the Authorization tab
- Click on Create token
- Give your token a name and assign it the Writer role
- Click Save token and copy the new token that appears in the Authorization page

Add LaunchDarkly as a destination in Hightouch
- Log in to Hightouch or create a free Hightouch account
- Click on Destinations in the left sidebar
- Click on Add destination in the top right corner
- Select LaunchDarkly in the destination catalog and click Continue to proceed
- Paste your API token into the API Access Token field and click Continue to proceed
- Give your destination a name and unique slug (e.g., “LaunchDarkly Production” and
launchdarkly-production
) - Click Finish to create your LaunchDarkly destination!
Step 2: Connect to your data source
- Connect to Airtable
- Connect to Amazon Athena
- Connect to Amazon Redshift
- Connect to Clickhouse
- Connect to Databricks
- Connect to Elasticsearch
- Connect to Firebolt
- Connect to Google BigQuery
- Connect to Google Sheets
- Connect to Looker
- Connect to Metabase
- Connect to MySQL
- Connect to Palantir Foundry
- Connect to PostgreSQL
- Connect to Rockset
- Connect to SFTP
- Connect to Snowflake
- Connect to SQL Server
- Connect to Trino
Connect to a sample database instead
users
table with names, emails, locations, and other user attributes. This sample source is available when you log in for the first time—no setup required.Step 3: Create a model
SELECT * FROM users WHERE location = 'Nashville';
- Click on Models in the left sidebar
- Click on Add model in the top right corner
- Select Demo Database as your source and click Continue to proceed
- Select SQL Editor as your modeling method
- Paste the SQL query from above into the editor on the left side of the page
- Click Preview to execute the query
- Click Continue to proceed
- Give your model a name and unique slug (e.g., "Users in Nashville" and
users-in-nashville
) - Select id as the primary key for your model
- Click Finish to create your model!
users
table down to only those located in Nashville. Next, we'll configure our sync to add these users to a LaunchDarkly segment.Step 4: Create a sync
- Click on Syncs in the left sidebar
- Click on Add sync in the top right corner
- Select Users in Nashville as your model and click Continue to proceed
- Select LaunchDarkly Production as your destination and click Continue to proceed
- Select which LaunchDarkly project you want to sync data to
- Identify which field from your model represents the identifier known to LaunchDarkly
- Select Segment Included Users as the field you wish to update in LaunchDarkly
- Select Create a new segment
- Give a name to your segment (e.g., "My beta test")
- Click Continue to proceed to the last step
- Select Interval to tell your sync to run on a set interval
- Configure your sync schedule to run every 5 minutes
- Click Finish to create your sync!


Troubleshooting
Common errors
Don't see your data in LaunchDarkly?

Use the Hightouch debugger
Set up sync alerts
- Connection issues with your data warehouse?
- Confusing API responses from destination systems?
- Unsupported destination objects or modes?
- Help with complex SQL queries?
Need help?
Our team is relentlessly focused on your success. We're ready to jump on a call to help unblock you.
or
Feature Requests?
If you see something that's missing from our app, let us know and we'll work with you to build it!
We want to hear your suggestions for new sources, destinations, and other features that would help you activate your data.