--- title: "PageAssist setup" date: "2025-09-12T08:22:23+00:00" summary: "Learn how to configure PageAssist for your website with step-by-step instructions on setup, widget design, and script installation." image: type: "page" url: "/web-governance/pageassist-setup" id: "02bf064d-d397-483b-b32f-230801216a90" --- Introduction ------------ This article provides instructions for admin users on how to configure PageAssist. Setup ----- This section provides instructions on how to set up PageAssist. 1. Navigate to the _Domain Overvie_w page. 2. Click **Action** on the same row as the domain that you want to add PageAssist to and select **Script Setup Guide** from the expanded list of options. ![The location of the Action button and the expanded list of options, on the same row as a domain.](https://acquia.widen.net/content/5721cbb7-fb99-405b-af36-756fe71843bb/web/WebGov_DomainOverview-ActionButtonAndMenu.png) The system opens the _Set up your domain_ page. 3. Click to toggle **Add PageAssist script** to **ON**. 4. Click the **Open PageAssist script settings** link beside the button to go to the PageAssist script settings. 5. Configure the settings as per the instructions below and then copy the script and add it to the website HTML code. In the HTML editor, paste the script into the HEAD tag or place it before the tag on every page. For more information, visit [How to add the script](/node/60216). ### Widget Icon setup This section provides instructions on how to set up the PageAssist widget icon. * **PageAssist position on page**: Click on the mini window to specify the location for the PageAssist icon to appear on the page. ![The Widget Icon Setup section of the PageAssist Script Settings pane. The fields are described in the document text.](https://acquia.widen.net/content/23f06c1e-a1f9-4b90-b4f6-f25f3aa34db4/web/Mon_PageAssist-ScriptSettings-WidgetIconSetup.png) * The options are: * Top left * Top center * Top right * Middle left * Middle right * Bottom left * Bottom center * Bottom right * **Margin from edge in pixels**: Top, Right, Bottom, Left. These fields are populated automatically with the default margins as per the location selected in the previous step. Edit the fields as desired to customize the icon location even further. * **Keep PageAssist on top**: Tick to select this option. This ensures that the PageAssist icon is always visible and situated on top of other page elements. * **Choose an Icon**: Select an icon to represent the PageAssist feature on the website. The choices are: * **Human figure with arms outstretched** * **Human figure in a wheelchair** * **Heart** * **Paintbrush** * **Icon shape**: Click the drop-down list to select an icon shape. The choices are _Circle_ and _Rounded Box_. ### Widget design and text This section provides instructions on how to set up the widget appearance. It is important to set up all of these items because if errors occur later on it might be difficult to determine which setting was missed. _Tip!_ The Acquia [Color Contrast Checker](https://www.acquia.com/products/acquia-web-governance/tools/color-contrast-checker) is a quick way to test the color combinations on websites and pages. ![The Widget Design and Text section on the Domain Setup page. The fields are described in the document text.](https://acquia.widen.net/content/f67d339d-676b-41c4-adc5-ec95be63347e/web/Mon_PageAssist-WidgetDesignAndText1.png) * **Menu Theme**: Click the drop-down arrow and select a menu theme. The choices are _Light_ and _Dark_. * **Main color**: Click in the input field to select a color with the color picker, or enter the RGB code for the color (usually a color that fits with the website theme). * **Text color**: Click in the input field to select a color with the color picker, or enter the RGB code for the color (usually a color that fits with the website theme). * **Link color**: Click in the input field to select a color with the color picker, or enter the RGB code for the color (usually a color that fits with the website theme). * **Button hover color**: Click in the input field to select a color with the color picker, or enter the RGB code for the color (usually a color that fits with the website theme). * **Color contrast ratio**: This number indicates the contrast ratio for the selected colors, and lets the user know if the contrast between the buttons and text is Bad (0-3.99) or Good (4 and above). _Tip!_ The [Color Contrast Checker](https://www.acquia.com/products/monsido/tools/color-contrast-checker) is a quick way to test the color combinations on websites and pages. * **Add icon border**: Tick to select this option. An input field expands below the selection. Select a border color with the color picker, or enter the RGB code for the color (usually a color that fits with the website theme). * **Upload logo**: Paste a logo image link (URL) into the field and then click **Upload Link**, or click **Browse** and navigate to the logo and then save it. ![Additional settings on the Widget Design setup section of PageAssist setup. Fields described in the document text.](https://acquia.widen.net/content/0cef9a44-734c-4133-980c-e4a464497cc5/web/Mon_PageAssist-ScriptSettings-WidgetDesignAndText2.png) * **Button hover message**: Enter a free-text message for users to see when they hover the mouse pointer over the PageAssist button. Click in the field to see the location on the mini-view to the right of this section. Note Remember that this message appears in the language as entered on all pages, it is not translated automatically. * **Enter a title for the PageAssist menu**: Click in the field to see the location on the mini-view to the right of the section. Note Remember that this message appears in the language as entered on all pages, it is not translated automatically. * **Title Text**: Enter a free-text description of the PageAssist menu for users. Click in the field to see the location on the mini-view to the right of the section. Note Remember that this message appears in the language as entered on all pages, it is not translated automatically. * **Reset Design**: Click to discard changes and revert to the default settings. ![The Widget Design and Text section on the Domain Setup page. The fields are described in the document text.](https://acquia.widen.net/content/b1868867-ea72-4ad4-94a5-85675c0c4c61/web/Mon_PageAssist-ScriptSettings-WidgetIconSetup2.png) * **Include Accessibility Statement**: Click to toggle the switch **ON**. The section expands with an upload field. Browse to and add an Accessibility Statement. * **Include custom info text**: Click to toggle the switch **ON**. The section expands with a free-text field. Add a custom message to users. * **Included languages**: Click the drop-down arrow and select the languages that are used on the website. Select as many as needed. * **Default language**: Click the drop-down arrow and select the default language that is used on the website. * **Add Skip to PageAssist**: Click to toggle the switch **ON**. This option adds a button that allows users to skip directly to PageAssist. * Click **OK** to save the settings. The window closes and the _Set up your domain_ page is visible, with the _Script_ section updated. ![The location of the OK button on the bottom right side of the Page Assist setup dialog.](https://acquia.widen.net/content/522b3af7-f862-443a-b587-06b1838c6935/web/Mon_PageAssist-Action-Setup-OKButton.png) ### Script This section provides instructions on how to find and add the PageAssist script to your website. Scroll down to the script section at the bottom of the _Set up your domain_ page. ![The location of the Copy Script button, in the Script section of the page.](https://acquia.widen.net/content/b7531398-a158-461e-9f6e-1b9a2571bbc2/web/Mon_AdminSettings-DomainSettings-CopyScriptButton.png) 1. In the _script_ section, click **Copy Script** (icon of two papers) to copy the script. Note Configure all of the modules and then copy and paste the entire script only one time. Repeat for each URL. For more information, visit [How to add the script](https://docs.acquia.com/acquia-optimize/how-add-script). Important The script is unique for each domain. It will not work to copy/paste from one to another. Websites ending in .com and .eu, for example, are considered different domains and it does not work to copy and paste the script. The script needs to be configured separately for each domain. 2. In the HTML editor, paste the script into the BODY tag of the website. Place the script on the pages to track - normally every page of the website. For more information, visit: * [How to add the script](https://docs.acquia.com/acquia-optimize/how-add-script) * [Google tag manager deployment](https://docs.acquia.com/acquia-optimize/admin/setup/script/gtm-deployment) 3. In the CMS (or the website template files), add the copied code to the HEAD tag or place it before the tag. _Tip_: It is also possible to insert the code just before or after any Google Analytics™ script or other utility scripts. After installation, browse the sites to ensure that the script loads correctly. 4. **Save** and commit the changes as needed. 5. Return to the platform and refresh the page. 6. Open the _Domain Settings_ page (gear icon). The column _Script_ shows the message **Script Installed**. ![The Script Installed indicator, on the same row as a domain on the Domain Overview page.](https://acquia.widen.net/content/02f27bcc-514f-4998-a5ac-f1769d05c6f7/web/WebGov_AdminSettings-ScriptInstalled.png) **Additional resources** ------------------------ For information about how your visitors can interact with PageAssist, visit: [PageAssist introduction](https://docs.acquia.com/acquia-optimize/pageassist-introduction) [PageAssist advanced configuration](https://docs.acquia.com/acquia-optimize/admin/setup/advanced-configuration)