Version:

Create Profiles Project in the RudderStack dashboard

Create your Profiles project from the RudderStack dashboard.

  •   4 minute read  

This guide lists the steps to create a Profiles project in the RudderStack dashboard.

Create Profiles project

  1. Log in to the RudderStack dashboard and go to Unify > Profiles option in the left sidebar.
  2. Click Create project.
Choose predefined template
  1. Select Web-based editor (IDE) on the next screen.
Web-based Editor method for creating Profiles project
info
You can also import an existing project from your Git repository.
  1. Enter a unique name and description for your Profiles project.
  2. Select a data warehouse from the dropdown.
warning

RudderStack currently supports the following warehouses for creating a Profiles project:

  1. Enter the schema name for the corresponding warehouse in the Schema field where you want your Profiles project to store the outputs.

  2. Click Create Profiles Project and select Open in editor mode.

  3. Enter the schema name you want to use for development purposes for your editing session and click Continue.

info

RudderStack recommends using a development schema while editing your project so that you can modify your YAML configuration files, run your changes within the editor, and validate the outputs in a separate development schema.

This makes it convenient to test your changes in the development schema without affecting the outputs in your production schema.

You will be able to see the following screen displaying a sample Profiles project with different YAML files:

  1. Edit the YAML files and save and commit the changes to your project.
  2. Click the Run button to run the project. Upon successful completion, you can view the outputs in your data warehouse.

Convert to a Git project

Once you set up a Profiles project in the dashboard, you can convert it to a configuration-based Git repository by uploading it either to GitHub, GitLab, or Bitbucket:

  1. Navigate to the Unify > Profiles option in the left sidebar to view all your Profiles projects.
  2. Click Convert to Git button next to the project you want to convert.
  3. Create a new Git repository.
  4. Enter the SSH URL of your Git repository to be used for your Profiles project and click Continue.
  5. Copy the SSH public key and click Add deploy key which will take you to your git repository’s Deploy keys section. See deploy keys section in the GitHub, GitLab, or Bitbucket documentation for more information.
warning
Make sure your Git repository has at least one commit for successful validation.
  1. Click Add deploy key, add a Title, paste your SSH public key, and click Add key.
  2. Click Continue to let RudderStack verify read access.
  3. Click Download project to download the Profiles project you set up in the dashboard.
  4. Commit the downloaded project to your Git repository.
  5. Once the project is committed successfully, return to the dashboard and click Convert Profiles project.

Start/Stop project run

Once created, you can:

  • Run your Profiles project using either of the following ways:
    • Clicking Run in the History tab of the project.
    • Programmatically using the Profiles API.

  • Stop a running project by clicking the red button in the Status column:
Stop profiles project
warning
It might take up to a few seconds to stop a running project.

Download project

To download the Profiles project, click the arrow icon corresponding to your Profiles project and click Download this project:

Activation API

Once downloaded, you can view the project folder structure, modify the files, or run various commands to execute the desired use-cases.

Project details

To view the Profiles project details, click the arrow icon corresponding to your Profiles project:

OptionDescription
EntitiesLists the entities, cohorts, features, activations, etc. for your Profiles project.
HistoryDisplays the history of Profile runs.
SettingsDisplays your profile settings and lets you delete your Profiles project. You can edit the project by clicking the edit icon next to each section.
AlertsSet up alerts and thresholds for the Profiles project.

Profile details

You can also view the details of a specific profile in your Profiles project:

  1. In your Profiles project’s Entities tab, click View button across the entity for which you want to see the profile:

    Activation API

  2. Click Profile Lookup tab to search a profile record.

  3. Type an available unique identifier like email, phone number, user id, anonymous id etc. and click Search user profile.

    Activation API

info

Note that:

  • It can take a few minutes for the data preview to show up in your profile’s History tab.
  • If you keep getting a blank screen, it may be because you do not have sufficient access. Make sure you have the relevant permissions with the ability to access PII. In case the problem persists, contact RudderStack support.

Questions? Contact us by Email or on Slack