Skip to content

Commit c71af08

Browse files
authored
docs: Add setup step 3 to the toolbar (#12181)
* docs: Add setup step 3 to the toolbar * link to Settings>Projects picker
1 parent 1930c2a commit c71af08

File tree

4 files changed

+6
-5
lines changed

4 files changed

+6
-5
lines changed
134 KB
Loading
-502 KB
Binary file not shown.

docs/product/dev-toolbar/index.mdx

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -40,10 +40,7 @@ After setting up the Dev Toolbar you’ll see a “Login to Sentry” button flo
4040
After clicking the button, you will see a pop-up window for logging in to Sentry.
4141
![Sentry log in pop up](./img/login-popup.png)
4242

43-
If it's your first time setting up the Dev Toolbar, there will be a button with a link to Sentry's Dev Toolbar settings page to configure your domain.
43+
If it's your first time [setting up the Dev Toolbar](/product/dev-toolbar/setup) , there will be a button with a link to Sentry's Dev Toolbar settings page to configure your domain.
4444
![Dev Toolbar configure domains button](./img/configure-domain.png)
4545

46-
You'll need to add your domain URL to Allowed Origins in Sentry on the **Settings > Project > Dev Toolbar** page.
47-
![Sentry's Dev Toolbar Settings Page](./img/sentry-toolbar-settings.png)
48-
4946
Learn more about setting up the toolbar, including configuring a feature flag provider and integrating the toolbar in different environments, on the next page.

docs/product/dev-toolbar/setup.mdx

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ You need to complete two steps to get the toolbar rendered on the page:
2222
```
2323
It is recommended that you add the script tag at the bottom of the page so it doesn’t block other critical JavaScript.
2424

25-
2. Call `window.SentryToolbar.init(initConfig)` to set up a toolbar instance on each page where you want to see the Dev Toolbar.
25+
2. Call `window.SentryToolbar.init(initConfig)` to set up a toolbar instance on each page where you want to see the Dev Toolbar. Take care to also [conditionally load the toolbar in your production environment](#deploying-to-production-environments).
2626
```html
2727
<html>
2828
<head>...</head>
@@ -36,6 +36,10 @@ You need to complete two steps to get the toolbar rendered on the page:
3636
</html>
3737
```
3838

39+
3. Edit [Project Settings](https://sentry.io/orgredirect/organizations/:orgslug/settings/projects/) in Sentry so the Toolbar is allowed to connect from your dev, staging, and production domains.
40+
![Sentry's Dev Toolbar Settings Page](./img/sentry-project-settings-toolbar.png)
41+
42+
3943
### Unmounting The Toolbar
4044

4145
If you have called `SentryToolbar.init({...})` to render the toolbar, but now want to manually remove or unmount it from the page, you can call the cleanup function that is returned from `init()`. This will unmount all the injected HTML and CSS. Login credentials will not be removed, so you can re-insert the toolbar and still be authenticated.

0 commit comments

Comments
 (0)