Wayfinder is a browser extension that measures the utilization of internal software applications. Wayfinder logs page structure and user activity for selected apps when accessed from a browser logged into a company profile. This data helps IT teams manage spend effectively and improve the user experience of internal applications.

Wayfinder is supported on Chrome, Microsoft Edge Enterprise, and some other Chromium based browsers. Not all use cases, platforms, sites, applications, or Fullstory features are supported. Please contact your account manager or sales representative for details.

Topics covered in this guide:

1. Configuring and downloading the extension
2. Local Deployment
3. Mass Deployment
4. Additional Resources

Configuring and downloading the extension

Wayfinder Configuration 

1. Sign in to your Fullstory account by going to app.Fullstory.com
2. Once you are signed in, click on the dropdown in the upper right of the wayfinder UI and click “Settings”.

3. On this page, you’ll configure your Wayfinder extension settings
   
   
   • Give the extension a custom name (*not editable yet)
     • Note: this name will appear in the browser when viewing the extension
   • Configure Fullstory Relay if applicable. We recommend using Fullstory Relay if your users frequently use ad blockers that might interfere with Fullstory recording traffic.
   • You can add help or support text tailored to your users.
   • You can also update the help URL to your own tailored document explaining how your org uses Wayfinder in lieu of our generic copy.
4. Once your settings are configured, click “Download Extension.”
5. A .zip file containing the extension and all resources will be downloaded. 

Local Deployment

Typically used for testing purposes.

1. Unzip the file and save it to your computer.
2. Under your browser’s extensions, look for “load unpacked extension” to load the extension from the disk.

Mass Deployment

Typically used to deploy Wayfinder to large quantities of users.

Microsoft Edge Enterprise

Prerequisites

Deployment of Wayfinder to Microsoft Edge Enterprise browsers requires the following prerequisites to be in place:

• Target systems joined a Microsoft Windows Domain
• Microsoft Edge Enterprise installed
• Microsoft Edge Enterprise group policy templates ( msedge.admx ) installed in group policy management console - policy templates are available for download from Microsoft

Hosting the Extension

You will need to host the Wayfinder extension within your environment in a location that your endpoints can access in order for them to install it. Fullstory recommends self-hosting the Wayfinder extension following Microsoft’s guidance for Edge Enterprise. Detailed instructions on self-hosting the extension are available at https://learn.microsoft.com/en-us/deployedge/microsoft-edge-manage-extensions-webstore 

Use Group Policy to ForceInstall Wayfinder

Once the prerequisites have been met and your extension is available to your endpoints, we will use Group Policy to apply a “ExtensionInstallForcelist” policy object to in-scope domain computers. 

1. In the Group Policy Editor, go to Administrative Templates> Microsoft Edge > Extensions > and then select Control which extensions are installed silently.
2. Select Enabled.
3. Click Show.
4. Enter the app ID or IDs of the extension or extensions you want to force-install.
   1. You must use the full syntax, which includes both the extension ID and the “Update URL” separated by a semicolon. The “Update URL” should be the URL that points to the extension manifest XML file in your environment. See https://learn.microsoft.com/en-us/DeployEdge/microsoft-edge-policies#extensioninstallforcelist for details.

The extension is installed silently without user interaction. Also, the user won't be able to uninstall or disable the extension. This setting overwrites over any blocklist policy that's enabled.

Google Chrome (Google Workspace)

Prerequisites

Deployment of Wayfinder to Google Chrome at scale requires the following pre-requisites to be in place:

1. Google Workspace (Buisiness Plus or higher license tier required)
   1. Workspace Configured to allow private deployment of Chrome Extensions (More information from Google available here and instructions for configuration available below)
2. Google Chrome installed on target endpoints
3. Google Workspace account signed in to chrome with Chrome Sync turned on
4. Active Chrome Developer Account using your Google Workspace Account. Create an account here (There’s a one-time, $5 fee for creating an account).

Publishing the Extension

In order to distribute the Wayfinder extension to your endpoints, you will first need to publish your custom Wayfinder extension package to the private Google Chrome Web Store for your Google Workspace domain. 

1. Download the custom packed extension from your Wayfinder dashboard 
   1. Click “Wayfinder” in the top right of your dashboard and choose “Settings”. 
   2. Click the “Download Extension” button to start the download.
2. Access your Chrome Developer Dashboard and create your own extension deployment.
   1. Login to https://chrome.google.com/webstore/devconsole
   2. Click “New Item” in the top right corner of the Developer Dashboard
   3. Upload the extension package you downloaded in step 1b
   4. Populate the required fields as appropriate for your environment
   5. Icon and Screenshots of appropriate size are required and provided here
      1. 
      2. 
   6. On the “Privacy” tab you will be required to enter a justification for the permissions the wayfinder extension leverages. You can enter “Private SaaS analytics within our Google Workspace domain. Not for general distribution.” for the justification fields and select the checkboxes as shown in the screenshot below.
      
   7. IMPORTANT: On the “Distribution” tab it is essential that you select “Private” under  the “Visibility” section and then select “Everyone at {Your Workspace Domain}” as in the screenshot below. This setting is critical for ensuring that your extension remains private to your organization, and that the review by Google will go as quickly as possible.
      
   8. Once all required fields have been filled in, press the “Submit for Review” button and select the “Publish ‘Wayfinder’ automatically after it has passed review” option in the pop up dialog. Finally, click on the “Submit for review” in the pop up.
   9. Keep an eye on your Chrome Developer Dashboard for the status of your submission to change from “Pending Review” to “Published” before proceeding.
   10. Note the extension ID for your Wayfinder extension on the Chrome Developer Dashboard, you will need this value to define your extension policy in the following steps. 

Define Your Workspace Extension Policy

In order to install the extension you have published in Chrome on your endpoints, you will need to define an Extension Policy within the Google Workspace Admin Console. 

1. Access your Google Workspace Admin Console at https://admin.google.com
2. Navigate to the “Chrome Browser” heading in the left nav menu and select “Apps & Extensions”
3. Select the desired scoping for the extension. For maximum flexibility, we recommend scoping the extension policy to one or more groups within your Google Workspace domain
4. Press the yellow “+” button in the bottom right corner of the page and select “Add Chrome app or extension by ID”
5. Enter the extension ID for your Wayfinder extension noted above and click “Save”
6. Select the desired policy parameters for your organization. We recommend the “Force install + pin to browser toolbar” option for most environments.

All in-scope Chrome browsers will automatically begin installing the extension. This process can take a few minutes. You can force a browser to update its extension policies by accessing chrome://policy/ from the Chrome address bar and clicking “Reload Policies”.

Additional Resources

Configuring Google Workspace to Allow Private Extension Deployment

In order to limit distribution of your domain’s custom Wayfinder extension to your Google Workspace users, you must first enable the “Allow users to publish private apps that are restricted to your domain on Chrome Web Store” option in Google Workspace Admin. 

1. Login to Google Workspace Admin with a Super User account
2. Go to the “Chrome Browser” > “Apps & extensions” section and click on the “Users & browsers”. Note: Make sure your selector on the left nav is on one of the Organizational units, not a user or group.
3. Click the “Additional Settings” cogwheel
   
4. Scroll down to “Additional app settings” and click on “Chrome Web Store Permissions”
   
5. Select “Allow users to publish private apps that are restricted to your domain on Chrome Web Store” from the configuration dropdown.
   
6. Save your settings

Chrome and Edge Extension Documentation

• Chrome
• Edge