---
updatedAt: 2026-01-15T06:38:45.000Z
agentTools:
  projectIndex: https://support.speedcurve.com/llms.txt
---

# Setup Guide

A step-by-step guide for admins

## Step 1 • Navigating your SpeedCurve Settings

The majority of your setup will be controlled within your Settings page. You can access your SpeedCurve Settings from the left nav, illustrated here.

<Image align="center" border={false} width="215px" src="https://files.readme.io/71ce38a-settings_nav.gif" />

After navigation, if you see the message below, it is because you do not have either Team or Admin privileges. For access, please request from your organization's Admin(s).

<Image align="center" border={false} width="787px" src="https://files.readme.io/b2e03a7-edit_permissions.gif" />

> 📘 Learn more:
>
> * [Add and edit users, admins, and teams](https://support.speedcurve.com/docs/edit-users-admins-teams)

## Step 2 • Understand your synthetic usage

The first section of your Settings page displays your synthetic usage. This informs you how many synthetic checks you have used for the month and how many are scheduled for use out of your allocated budget. More information about managing your usage, including viewing your usage history can be found below.

<Image align="center" border={false} width="793px" src="https://files.readme.io/f2e33c4-usage.gif" />

> 📘 Learn more:
>
> * [Manage checks](https://support.speedcurve.com/docs/manage-checks)
> * [Usage history](https://support.speedcurve.com/docs/usage-history)

## Step 3 • Modifying your global settings

Before you add sites and URLs to your synthetic testing, you need to identify which settings you'll want to use globally. Here is a video walkthrough of some of the common global settings you'll use, including regions, browsers, test times, and number of checks per test.

**Adding additional Regions, Browsers, Times and Checks**

<Embed url="https://www.youtube.com/watch?v=7z0fXATG9OI" href="https://www.youtube.com/watch?v=7z0fXATG9OI" html="%3Ciframe%20class%3D%22embedly-embed%22%20src%3D%22%2F%2Fcdn.embedly.com%2Fwidgets%2Fmedia.html%3Fsrc%3Dhttps%253A%252F%252Fwww.youtube.com%252Fembed%252F7z0fXATG9OI%253Ffeature%253Doembed%26display_name%3DYouTube%26url%3Dhttps%253A%252F%252Fwww.youtube.com%252Fwatch%253Fv%253D7z0fXATG9OI%26image%3Dhttps%253A%252F%252Fi.ytimg.com%252Fvi%252F7z0fXATG9OI%252Fhqdefault.jpg%26key%3Df2aa6fc3595946d0afc3d76cbbd25dc3%26type%3Dtext%252Fhtml%26schema%3Dyoutube%22%20width%3D%22854%22%20height%3D%22480%22%20scrolling%3D%22no%22%20title%3D%22YouTube%20embed%22%20frameborder%3D%220%22%20allow%3D%22autoplay%3B%20fullscreen%22%20allowfullscreen%3D%22true%22%3E%3C%2Fiframe%3E" />

> 📘 Learn more:
>
> For a full walkthrough of your Settings options, see the videos posted in [Admin Settings](https://support.speedcurve.com/docs/admin-settings)

## Step 4 • Add sites and URLs for testing

**Sites**\
It's important to know that each site you test can have a different settings configuration. For example, you may wish to test your own site several times a day across a number of browsers and regions. You may wish to test a competitor's site only once a day across a smaller number of browsers and regions.

To manage an individual site's test settings, click on that site on your main Settings page. Your site settings page is where you'll define the URLs you want to test for a given site, as well as other test settings you want to use from your global settings above. The configuration of a site is intended to be used to declare the unique web property you are testing. This includes environments you may be testing (i.e. production, staging) or other sites outside of your control, such as a competitor's site.

> 🚧 Important!
>
> When defining a new site, it is very important that you select what *type* of site it is. This is required for  use in [Competitive benchmarking](https://support.speedcurve.com/docs/competitive-benchmarking)

**URLs**\
Within site settings, you will define which URLs you want to test for a site. This is accomplished by entering in a url or by creating a [synthetic script](https://support.speedcurve.com/docs/synthetic-test-scripts). Beside each URL, you will also apply a page label name, which will help you to identify the URL in your dashboards and most importantly allow you to compare other urls in cases of competitive benchmarking and matching up with your RUM data.

<Image align="center" alt={1510} border={false} caption="Simple url" title="url.gif" src="https://files.readme.io/5d1eb0e-url.gif" width="755px" />

<Image align="center" alt={1702} border={false} caption="Url defined by a script" title="url_script.gif" src="https://files.readme.io/463e435caeed82695f945bac1ecbac1728bf8989cbca7bdf42ee9afc3d99bbc8-scripting.jpg" width="851px" />

> 🚧 Important!
>
> **[Defining page labels](https://support.speedcurve.com/docs/synthetic-page-labels) is a critical step in your setup.** Using the same page labels for competitors will allow you to benchmark key pages. For example, if you want to compare your home page to a competitor's home page, you will need to label each URL 'Home'. Matching up your synthetic page labels with your [RUM page labels](https://support.speedcurve.com/docs/rum-page-labels) enables correlation between RUM and synthetic data for use in Vitals, Improve and Favorites dashboards.

**Adding RUM domains to a synthetic Site**\
Contained within your Site settings is a section for RUM Settings. This is NOT the primary place you'll edit your RUM settings (see below). This is where you indicate:

* Which domains you want to collect RUM data for
* Which RUM domains you want to associate with the Site. This is useful when you are using both datasets in areas such as the [Vitals dashboard](https://support.speedcurve.com/docs/vitals-dashboard-walkthrough), [Custom dashboards & charts](https://support.speedcurve.com/docs/custom-charts-dashboards), [Home dashboard](https://support.speedcurve.com/docs/home-dashboard) and others.

<Image align="center" border={false} src="https://files.readme.io/3208311-rum_site_settings.gif" />

Watch this video explainer for a full walkthrough of your site settings.

<Embed url="https://www.youtube.com/watch?v=zjrPzI0-32Y" href="https://www.youtube.com/watch?v=zjrPzI0-32Y" html="%3Ciframe%20class%3D%22embedly-embed%22%20src%3D%22%2F%2Fcdn.embedly.com%2Fwidgets%2Fmedia.html%3Fsrc%3Dhttps%253A%252F%252Fwww.youtube.com%252Fembed%252FzjrPzI0-32Y%253Ffeature%253Doembed%26display_name%3DYouTube%26url%3Dhttps%253A%252F%252Fwww.youtube.com%252Fwatch%253Fv%253DzjrPzI0-32Y%26image%3Dhttps%253A%252F%252Fi.ytimg.com%252Fvi%252FzjrPzI0-32Y%252Fhqdefault.jpg%26key%3Df2aa6fc3595946d0afc3d76cbbd25dc3%26type%3Dtext%252Fhtml%26schema%3Dyoutube%22%20width%3D%22854%22%20height%3D%22480%22%20scrolling%3D%22no%22%20title%3D%22YouTube%20embed%22%20frameborder%3D%220%22%20allow%3D%22autoplay%3B%20fullscreen%22%20allowfullscreen%3D%22true%22%3E%3C%2Fiframe%3E" />

> 📘 Learn more:
>
> * [Test scripting](https://support.speedcurve.com/docs/synthetic-test-scripts)
> * [Scripting reference](https://support.speedcurve.com/docs/synthetic-scripting-guide)
> * [Competitive benchmarking](https://support.speedcurve.com/docs/competitive-benchmarking)
> * [Synthetic page labels](https://support.speedcurve.com/docs/synthetic-page-labels)
> * [RUM page labels](https://support.speedcurve.com/docs/rum-page-labels)

## Step 5 • Configuring RUM

Real user monitoring (RUM) is a critical part of every solid performance management plan. If you choose to enable RUM within SpeedCurve (and we hope you do!) you'll need to follow some basic steps outlined in RUM Settings.

### 1 • Add the RUM snippet to your pages and set your sample rate

You can get the snippet at any time by going to **Settings > Edit RUM**.

<Image align="center" border={false} src="https://files.readme.io/5f9ae72-snippet.gif" />

**Where to insert the snippet**

The `lux.js` script is loaded asynchronously so it won't harm the performance of your site. It's best to put the snippet as early in the page as possible, i.e. at the top of the HEAD element. This ensures that we are able to collect as much data as possible for each page.

**Single-Page App (SPA)**

Follow the guide for using [SpeedCurve RUM with a SPA.](https://support.speedcurve.com/docs/single-page-applications)

**How to adjust your sample rate**

You can [set your RUM sample rate](https://support.speedcurve.com/docs/sample-rate) on your Settings page. The default sample rate is 100%. You should change the sample rate to a value that matches the [plan](https://www.speedcurve.com/pricing) you want to sign up for.  

For example, if your site typically gets 900 million page views per month, and you want a RUM plan that covers a maximum of 10 million page views per month, then set the sample rate to 1%. Questions about what you should set your sample rate to? [Check out this post](https://www.speedcurve.com/blog/sampling-rum/).

### 2 • Add the domains you want to monitor

As mentioned above, you'll add the domains you want to monitor to your Site Settings. They will be shown in your RUM Settings page once they've been added.

<Image align="center" border={false} src="https://files.readme.io/e9566fb-rum_settings_domains.gif" />

### 3 • Add page labels

This is a **crucial step** in your RUM setup. By default, pages are grouped by their page title (document.title), but you'll want to segment your pages by type or template. This is **very** important for using great features such as the vitals dashboard and combining your synthetic and RUM data. This also streamlines the number of page labels in your RUM filters, making the data much more actionable.

Page labels can be created in one of three ways (in priority order):

1. Using the RUM JS API
2. Assigning page labels based on url patterns
3. Using existing JS variables

> ❗️ Warning
>
> If not matched with one of the methods above, document.title for the page will be used. This can lead to a large number of page labels, making it difficult to navigate and filter your data.

#### Using the [RUM JS API](https://support.speedcurve.com/docs/rum-js-api)

**Pros:** Absolute control over labeling\
**Cons:** Requires code changes

To programmatically assign labels, simply call the LUX API from your pages as illustrated here:

```javascript
LUX = window.LUX || {};
LUX.label = "article";
```

#### Assigning page labels based on url patterns

**Pros:** No code changes and control is in the hands of the admin\
**Cons:** Could be overwritten/changed by other Admins and changes are not retroactive

From the top menu of your RUM Settings, click on 'Page Label URL Rules'. Then click 'Add a Page Label' to get started.

<Image align="center" border={false} width="792px" src="https://files.readme.io/2e024cc-add_label.jpg" />

Next, create a Page Label name and enter in one or more URL rules. URL rules are defined by entering the path and (optionally) a wildcard (\*). In the example below, we are matching on a trailing '/' or the path '/home.php' to define the 'Home' page label. Note that page rules are matched in order (first match whens). If you have patterns that match more than one url, the first rule in the list will be chosen.

<Image align="center" border={false} width="745px" src="https://files.readme.io/c7bad23-rules.jpg" />

#### Using an existing JavaScript variable on your pages

**Pros:** Uses common definition of a 'page' when using across toolsets (i.e. marketing analytics)\
**Cons:** Limited by what exists on the page

From the top menu of your RUM Settings, click on 'Page Label URL JS Variable', then simply type the name of the variable referenced within your page.

<Image align="center" border={false} width="790px" src="https://files.readme.io/1268a84-js_variable.jpg" />

### 4 • Advanced RUM settings

The advanced tab contains settings that can be changed from the default values. For a full walkthrough see [Advanced RUM settings](https://support.speedcurve.com/docs/advanced-rum-settings).

<Image align="center" border={false} src="https://files.readme.io/72b5465-advanced.gif" />

## Step 6 • Add Users, Admins and Teams

Remember, performance is a team sport! Now that you've configured SpeedCurve, you'll want to invite others to take part.

**Adding Users**\
To add a new user, navigate to 'Team' from your account settings in the lower left corner.

<Image align="center" border={false} width="398px" src="https://files.readme.io/e8614c5-team_nav.gif" />

Next, click on Users -> +ADD USER. Enter the name, email and select the permissions for the account (User or Team Admin). By default, users are read-only. This means they aren't able to edit the settings covered in this guide. If you select 'Team Admin', the user will have the ability to edit all Settings for the team.

<Image align="center" border={false} width="796px" src="https://files.readme.io/82bf41e-new_user.gif" />

**Adding Org Admins**\
Org admins have all of the permissions of a Team Admin as well as the ability to manage Billing and Teams, and to view the Event log. To create a new Org Admin, navigate to 'Admin' from your account settings in the lower left corner and click on 'Admin'.

<Image align="center" border={false} width="398px" src="https://files.readme.io/c05b055-admin_nav.gif" />

Next, click on Admins. Enter the name and email and click on the 'Add Admin' button.

<Image align="center" border={false} width="782px" src="https://files.readme.io/d3fbcef-add_org_admin.gif" />

**Adding Teams**\
In some cases, it may make sense for you to create additional teams. This is typically done in an agency model, or within an organization that wants to keep performance data siloed. It's important to know that users can only see data for the Team(s) they are members of. Org Admins have the ability to access all Teams.

To create a new team, from the Admin menu, click on Teams -> +ADD TEAM. From there, you'll fill out the form for a new Team and then hit the 'Save' button.

<Image align="center" border={false} width="820px" src="https://files.readme.io/ded8079-add_team.gif" />

Watch these videos for a walkthrough of your RUM Settings and Page Labels.

<Embed url="https://www.youtube.com/watch?v=Rr4iMFL5ZE0" href="https://www.youtube.com/watch?v=Rr4iMFL5ZE0" html="%3Ciframe%20class%3D%22embedly-embed%22%20src%3D%22%2F%2Fcdn.embedly.com%2Fwidgets%2Fmedia.html%3Fsrc%3Dhttps%253A%252F%252Fwww.youtube.com%252Fembed%252FRr4iMFL5ZE0%253Ffeature%253Doembed%26display_name%3DYouTube%26url%3Dhttps%253A%252F%252Fwww.youtube.com%252Fwatch%253Fv%253DRr4iMFL5ZE0%26image%3Dhttps%253A%252F%252Fi.ytimg.com%252Fvi%252FRr4iMFL5ZE0%252Fhqdefault.jpg%26key%3Df2aa6fc3595946d0afc3d76cbbd25dc3%26type%3Dtext%252Fhtml%26schema%3Dyoutube%22%20width%3D%22854%22%20height%3D%22480%22%20scrolling%3D%22no%22%20title%3D%22YouTube%20embed%22%20frameborder%3D%220%22%20allow%3D%22autoplay%3B%20fullscreen%22%20allowfullscreen%3D%22true%22%3E%3C%2Fiframe%3E" />

<Embed url="https://www.youtube.com/watch?v=B1OB6DXxY24" href="https://www.youtube.com/watch?v=B1OB6DXxY24" html="%3Ciframe%20class%3D%22embedly-embed%22%20src%3D%22%2F%2Fcdn.embedly.com%2Fwidgets%2Fmedia.html%3Fsrc%3Dhttps%253A%252F%252Fwww.youtube.com%252Fembed%252FB1OB6DXxY24%253Ffeature%253Doembed%26display_name%3DYouTube%26url%3Dhttps%253A%252F%252Fwww.youtube.com%252Fwatch%253Fv%253DB1OB6DXxY24%26image%3Dhttps%253A%252F%252Fi.ytimg.com%252Fvi%252FB1OB6DXxY24%252Fhqdefault.jpg%26key%3Df2aa6fc3595946d0afc3d76cbbd25dc3%26type%3Dtext%252Fhtml%26schema%3Dyoutube%22%20width%3D%22854%22%20height%3D%22480%22%20scrolling%3D%22no%22%20title%3D%22YouTube%20embed%22%20frameborder%3D%220%22%20allow%3D%22autoplay%3B%20fullscreen%22%20allowfullscreen%3D%22true%22%3E%3C%2Fiframe%3E" />

> 📘 Learn more:
>
> * [RUM settings](https://support.speedcurve.com/docs/rum-settings)
> * [RUM page labels and URL rules](https://support.speedcurve.com/docs/rum-page-labels)
> * [RUM domains FAQ](https://support.speedcurve.com/docs/rum-domains-faq)