Skip to content

fix: broken Auth0 Management Dashboard links#388

Merged
avanscoy merged 2 commits intomainfrom
fix/auth0-dashboard-links
Dec 10, 2025
Merged

fix: broken Auth0 Management Dashboard links#388
avanscoy merged 2 commits intomainfrom
fix/auth0-dashboard-links

Conversation

@btiernay
Copy link
Contributor

@btiernay btiernay commented Dec 5, 2025

Description

Fixes broken Auth0 Management Dashboard links.

Copy link
Contributor

@mikemimik mikemimik left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@btiernay reviewed about 7 files and found some inconsistencies that sort of thread through all the files. Have a look and let me know if you have any questions.

* If you encounter this scenario after managing your custom providers through multiple methods (Terraform, Auth0 Dashboard, <Tooltip tip="Management API: A product to allow customers to perform administrative tasks." cta="View Glossary" href="/docs/glossary?term=Management+API">Management API</Tooltip>, and/or Auth0 SDKs) it is advisable to reset the custom provider configuration. We recommend you refrain from using multiple methods to manage your custom provider.

To reset the custom email provider, navigate to [Auth0 Dashboard > Branding](/docs/$manage_url#/branding) and select **Email Provider**. Then, select the **Reset** button to restore your custom provider to its default No newline at end of file
To reset the custom email provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/branding) and select **Email Provider**. Then, select the **Reset** button to restore your custom provider to its default
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🖐🏽 Change Request: https://manage.auth0.com/#/branding doesn't redirect you to the place this document is talking about. In the document there is references to this address: https://manage.auth0.com/dashboard/{locale}/{tenant_name}/templates/provider. If we update this to https://manage.auth0.com/#/templates/provider we'll redirect to the correct page.

Suggested change
To reset the custom email provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/branding) and select **Email Provider**. Then, select the **Reset** button to restore your custom provider to its default
To reset the custom email provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/templates/provider) and select **Email Provider**. Then, select the **Reset** button to restore your custom provider to its default

Out of Scope:

✍🏽 Content: There is no 'reset' button on this page anymore. This doc needs to be updated to talk about the toggle switch that exists on the page that you would turn off to reset back to default.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looking at this, then the "select Email Provider" statement becomes superfluous. Do you think rewriting this content should be in scope of this link focused change set? Happy to add while I'm in here, but I think there will be many such observations across the docs content.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is still a Reset button at the bottom of the page in Dashboard, so we can go with Bobby's suggestion here.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@mikemimik - I'll make a ticket to update the step on this doc and the next one. For this PR tho, we can go with Bobby's suggestion to fix the link. Strange that the old variable translated this way.

* If you encounter this scenario after managing your custom providers through multiple methods (Terraform, Auth0 Dashboard, <Tooltip tip="Management API: A product to allow customers to perform administrative tasks." cta="View Glossary" href="/docs/glossary?term=Management+API">Management API</Tooltip>, and/or Auth0 SDKs) it is advisable to reset the custom provider configuration. We recommend you refrain from using multiple methods to manage your custom provider.

To reset the custom phone provider, navigate to [Auth0 Dashboard > Branding](/docs/$manage_url#/branding) and select **Phone Provider**. Then, select the **Reset** button to restore your custom provider to its default No newline at end of file
To reset the custom phone provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/branding) and select **Phone Provider**. Then, select the **Reset** button to restore your custom provider to its default
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🖐🏽 Change Request:

(☝🏽 Similar to previous comment - including out of scope)

Suggested change
To reset the custom phone provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/branding) and select **Phone Provider**. Then, select the **Reset** button to restore your custom provider to its default
To reset the custom phone provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/phone/templates/phone/provider) and select **Phone Provider**. Then, select the **Reset** button to restore your custom provider to its default

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same comment here. If I make such a content change then "select Phone Provider." becomes superfluous.

Un produit permettant aux clients d’effectuer des tâches administratives." cta="Voir le glossaire">Management API</Tooltip>, and/or Auth0 SDKs) it is advisable to reset the custom provider configuration. We recommend you refrain from using multiple methods to manage your custom provider.

To reset the custom email provider, navigate to [Auth0 Dashboard > Branding](https://auth0.com/docs/$manage_url#/branding) and select **Email Provider**. Then, select the **Reset** button to restore your custom provider to its default No newline at end of file
To reset the custom email provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/branding) and select **Email Provider**. Then, select the **Reset** button to restore your custom provider to its default
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🖐🏽 Change Request:

  • ☝🏽 Similar to previous comment
  • This needs to be translated into French
Suggested change
To reset the custom email provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/branding) and select **Email Provider**. Then, select the **Reset** button to restore your custom provider to its default
To reset the custom email provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/templates/provider) and select **Email Provider**. Then, select the **Reset** button to restore your custom provider to its default

Un produit permettant aux clients d’effectuer des tâches administratives." cta="Voir le glossaire">Management API</Tooltip>, and/or Auth0 SDKs) it is advisable to reset the custom provider configuration. We recommend you refrain from using multiple methods to manage your custom provider.

To reset the custom phone provider, navigate to [Auth0 Dashboard > Branding](https://auth0.com/docs/$manage_url#/branding) and select **Phone Provider**. Then, select the **Reset** button to restore your custom provider to its default No newline at end of file
To reset the custom phone provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/branding) and select **Phone Provider**. Then, select the **Reset** button to restore your custom provider to its default
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🖐🏽 Change Request:

  • ☝🏽 Similar to previous comment
  • This needs to be translated into French
Suggested change
To reset the custom phone provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/branding) and select **Phone Provider**. Then, select the **Reset** button to restore your custom provider to its default
To reset the custom phone provider, navigate to [Auth0 Dashboard > Branding](https://manage.auth0.com/#/phone/templates/phone/provider) and select **Phone Provider**. Then, select the **Reset** button to restore your custom provider to its default

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should translations be in scope here? Again, much more content on this page will need to be translated.

@btiernay
Copy link
Contributor Author

btiernay commented Dec 6, 2025

Good feedback, thanks @mikemimik will address!

Some of these I had to interpolate because content was both mangled and truncated. Other bits seem to be inconsistent based on existing examples (e.g. French link titles being in English seems common, but gen on the same page). I think generally the translation need a deep review for these types of things.

@mikemimik
Copy link
Contributor

Hey @btiernay, I agree with what you're saying, the scope of the change shouldn't include the translations, just pointing it out so we'll remember to have a look. The wider content team is doing an audit next year, so things like this will get worked out. I also don't think it's in scope to update any words, just making sure the links get to the correct location is good enough.

If we're sure that all the links into the management dashboard are updated correctly, I'm happy to approve.

@avanscoy avanscoy dismissed mikemimik’s stale review December 10, 2025 18:59

The content team will do the suggested updates in another PR

@avanscoy avanscoy merged commit 073d674 into main Dec 10, 2025
10 checks passed
@avanscoy avanscoy deleted the fix/auth0-dashboard-links branch December 10, 2025 18:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants