Browserstack Documentation Documentation
Documentation home icon Separator

    Domain controls

    Claim ownership of organization domain(s) and capture the domain users

    Note: Domain Verification and Managed Accounts is an Enterprise only feature. Learn more about Enterprise plans.

    Introduction

    Domain Capture allows administrators to verify domain ownership, manage domain users and ensure their usage falls within the boundaries of their Enterprise subscription. When domain capture is on, any user with a verified company domain can choose to get added to the company’s Enterprise subscription.

    Enable domain capture now to ensure more secure BrowserStack configuration for Enterprise as well as a smoother experience for your end users.

    How does domain control empowers administrators?

    • Verify and claim ownership of your company’s email domain(s) to establish complete control of them and prevent unauthorized usage of your company’s sensitive data.
    • Discover users outside your Enterprise subscription and invite them to join the subscription.

    Domain verification and capture ensures all users’ adherence to internal security, compliance, and data access policies as well as prevent unauthorised users from using your domain for abusive or fraudulent activities on BrowserStack

    Who can initiate Domain Capture?

    Anyone with the organisation Owner or Admin roles on BrowserStack can add/verify domain ownership and enable domain capture.

    How does it work?

    Step 1: Verify Domain Ownership

    You can verify your ownership by selecting any one of the following verification methods.

    1. Sign in to BrowserStack Admin portal and visit the Settings section.
    2. Click Domains on the left navigation bar to navigate to the Domains page.
    3. Click Add Domain button. Domains page
    4. In the Add Domain dialog, select the “DNS” tab.
    5. Visit your domain registrars page in a new tab and follow the instructions specified in Step 1.
    6. Once you add a new TXT record on your DNS host, switch tabs and return to the Add Domain dialog.
    7. In the input box provided in Step 2, enter the domain you wish to verify and click Verify domain Confirm Verify Domain
    8. BrowserStack will periodically check to see if your changes are published (this may take some additional time depending on your domain registrar). Once we find the new TXT record, the domain status will automatically be marked VERIFIED.
    1. Sign in to BrowserStack Admin portal and visit the Settings section.
    2. Click Domains on the left navigation bar to navigate to the Domains page.
    3. Click Add Domain button. Domains page
    4. In the Add Domain dialog, select the “HTTPS” tab.
    5. Download the verification file and upload it to the root folder of your domain’s website.
    6. Verify that the page https://(your_domain)/browserstack-domain-verification.html is accessible Confirm Verify Domain
    7. Once BrowserStack is able to access this page and confirm that your domain verification token is found on it, the domain status will be marked VERIFIED.

    If your company owns multiple web domains/sub-domains, you can add and verify them each individually.

    Note: You can use the same TXT record or HTML file for verifying multiple domains.

    Step 2: Enable domain capture

    How to enable domain capture

    1. In the Domains table, find the the domain you wish to capture.
    2. in the Capture Domain column, toggle the switch to ON . Enable domain capture
    3. Click Confirm on the dialog that opens, to capture the domain.
    Note: For newly captured domains, Managed Users data will start to reflect only after a sync, which may take a few minutes.

    Step 3: Start managing user accounts with the domain

    Once domain capture is enabled, you can start managing user accounts with the domain. Furthermore,

    • You can view members who have created BrowserStack accounts using email address matching the verified domain.
    • You can invite such members to your group’s plan since they are dispersed across different free trial groups on BrowserStack.
    • You can review their requests to join your group’s plan.
    • Users registered with your domain but are not part of your group will be notified of your ownership of the domain and can request to join your group.
    1. Sign in to BrowserStack Admin portal and visit the User Management section.
    2. On the left navigation bar, click Managed Users to navigate to the Managed accounts page.
    3. Click on the Users tab to access managed users table. This table contains information on user accounts that are registered with your domain emails. Managed users table
    4. Locate the member you want to add to your group and click Add User.
    5. Add user dialog will appear. In this dialog, select the role(s), product accesses and the team to which you want to add the member to.
    6. Click Add to confirm. Add managed user dialog
    7. An invitation to join your group will be sent to the member. Once the member accepts it, they will be added to your Organization’s account on BrowserStack.
    1. Sign in to BrowserStack Admin portal and visit the User Management section.
    2. On the left navigation bar, click Managed Users to navigate to the Managed accounts page.
    3. Click on the Requests tab to access the managed user requests table. This table details the requests made by members to join your group. Managed user requests table
    4. Locate the request you want to review. Click on Approve to review details before adding the member to your group.
    5. A dialog will appear. If required, you can review and modify the specifics(role, product accesses) of the request before approving it, on this dialog.
    6. Click Approve to confirm. Review request dialog
    7. Member will be added to your group with the approved role and product accesses.

    Frequently asked questions

    Why is my domain not verified?

    After a domain is added for verification, BrowserStack will attempt to access the necessary TXT record (for DNS method) or HTML file (for HTTPS method).

    • If the TXT record/file is detected, the verification status is marked as VERIFIED instantly.
    • Otherwise, until your changes are published, the verification status is marked VERIFICATION IN PROGRESS for upto 72 hours.
    • If the updates are still inaccessible after 72 hours, the domain is marked UNVERIFIED. In this case, you may retry verification by selecting Verify Again from the 3 dot menu.

    If you are having trouble verifying your domain even after multiple attempts,

    • For “DNS” method : Contact your domain registrar for assistance
    • For “HTTPS” method : Verify that you are able to access https://(your_domain)/browserstack-domain-verification.html

    How do I modify an invitation to add a managed user

    You may resend, modify, or withdraw an invitate thats been sent as long as the recipient has not already accepted it. Simply visit the Pending Invitations table in the Invitations section.

    Can anyone request to join the domain owner’s group?

    No. Only members who create BrowserStack accounts with an email address matching one of the group’s verified domains and are not part of a paid plan may request to join the domain owner’s group. Additionally, only those members who can confirm their email addresses will be allowed to request to join the group.

    How can I request to join my domain owner’s group?

    1. Sign in to BrowserStack and visit the Account & Profile section.
    2. On the Profile card, you’ll see a link to join your team, if your organisation has verified ownership of their domain. Click on Request Access.
    3. On the dialog that appears, select the role and product accesses you require in your org’s group and send the request by clicking on “Request”. Existing user - join team
    1. Immediately after you sign-up, you’ll be redirected to see a link to join your team, if your organisation has verified ownership of their domain. Click on Request Access.
    2. On the dialog that appears, select the role and product accesses you require in your org’s group and send the request by clicking on “Request”. New sign up user - join team
    Note: As a security measure, members who haven’t previously confirmed their email address will be prompted to do so before raising a request to join their Org’s account.

    Need some help?

    If you have any queries, please reach out to your respective CSMs or get in touch with support

    We're sorry to hear that. Please share your feedback so we can do better

    Contact our Support team for immediate help while we work on improving our docs.

    We're continuously improving our docs. We'd love to know what you liked






    Thank you for your valuable feedback

    • ON THIS PAGE

      Is this page helping you?

      Yes
      No

      We're sorry to hear that. Please share your feedback so we can do better

      Contact our Support team for immediate help while we work on improving our docs.

      We're continuously improving our docs. We'd love to know what you liked






      Thank you for your valuable feedback!

      By clicking 'Accept All', you agree to the use of all types of cookies to enhance site navigation. For more information, please visit our Cookie Policy.

      Accept All Reject All

      Talk to an Expert
      Download Copy