A source is a platform or an application (web, mobile, server-side, or a third-party cloud app) from where RudderStack tracks and collects the event data.

You can configure a source for every unique source of data. You can also create multiple sources for each website or application from where you want to track the data.

The Sources option is provided in the left navigation bar in the RudderStack dashboard. It lets you view all your configured sources, as shown:

RudderStack sources

Adding a source

Follow these steps to add a source in RudderStack:

  1. Log into your RudderStack dashboard.
  2. Click Add Source and select the source you want to set up in RudderStack.
RudderStack classifies the sources into following categories:
  1. Assign a name to the source and click Next to configure the source successfully.
Source configuration
Note the source Write Key in the above image. It is required while configuring the RudderStack SDK to track and collect events from your source platform.
Setting up Cloud Extract or Reverse ETL sources require some additional configuration. Refer to the relevant source-specific documentation for details.

Source details

To get details about a configured source, click it to see the following options:

  • Rename: Lets you rename the source by clicking the edit icon next to the source's name.
Rename source
  • Live Events: Lets you view the real-time event data flowing through RudderStack. Refer to Live Events for more information.
  • Setup: Includes the installation snippet and the write key to set up your source.
Setup tab
  • Write Key: Required to send the data from your source. For example, you can load the RudderStack JavaScript SDK on your website to track and collect the events by running the following snippet:
rudderanalytics.load(WRITE_KEY, DATA_PLANE_URL, options);
  • Overview: Gives you a quick overview of the source, including metrics like the number of events ingested in the last 24 hours.
  • Add Destination: Lets you add a new destination connected to this source.
If you have already configured a destination in RudderStack, you can also use it by clicking on Add Destination > Use Existing Destination.
  • Events: Displays all the latest metrics related to the event delivery such as number of events successfully delivered, failed events, etc. You can also filter these by the time period (past 1 day, 7 days, or 30 days).
  • Settings: Provides additional source-related settings, like:
    • Enabled: Lets you enable or disable syncing data from this source.
    • Source ID: Unique identifier associated with your source.
    • Permanently delete source: Lets you delete a source by clicking on the Delete button.
Before deleting a source, make sure there are no destinations connected to it.
  • Tracking Plans: Lets you link a tracking plan with the source.
  • Permissions: Lets you determine which members in your workspace can make changes to this source.
Refer to the Permissions Management guide for more details on this option.


What is a write key? Why is it required?

The write key (also referred to as the source write key) is used to integrate the RudderStack SDK with your application before tracking events from it. You can click a source and view it in the Setup tab.

Contact us

For more information on the topics covered on this page, email us or start a conversation in our Slack community.

On this page