> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superoffice.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install WebTools

> How to install WebTools per user.

SuperOffice WebTools lets you integrate documents with SuperOffice CRM. Choose your platform below to view the installation steps.

<Note>
  In SuperOffice 11.10 and older, WebTools for Windows consists of two components: Mail Link and Web Extensions. In SuperOffice 11.11 and newer, WebTools for Windows provides document integration only.

  For macOS, WebTools consists of only one component: WebTools. To integrate your email, please [configure your SuperOffice Inbox][1].
</Note>

## Pre-requisites

* You might need administrative rights to SuperOffice CRM to make systems connections (depends on your organization's security settings).
* For Microsoft 365 connections, check your rights in the Microsoft 365 environment.
* If you are using a Citrix connection, your IT team must set up the connections for you.
* For MacOS, you need the Office package to have documents integrated. SuperOffice provides integration for Microsoft 365 document applications only, and not for Apple applications Pages, Numbers, and Keynote.

## Steps

<Tabs>
  <Tab title="SuperOffice 11.11 and newer (Windows)">
    1. Go to <i class="ph ph-user-circle" aria-label="Personal settings" /> and select **Download** > **SuperOffice WebTools**.

    2. In the dialog, click **Download** to download the installation file.

    3. Click the downloaded **SuperOffice.Web.Tools.exe** file in the downloads section in your browser.

    4. Click **Continue**.

    5. Click **Install**.

    6. If you are asked for your user name and password to install, enter them and click **Install Software**.

    7. When the message "The installation was successful" is displayed, close the dialog.

    8. Finally, log out of SuperOffice CRM, close the browser window. Then reopen your browser window to log in again.

    With WebTools installed, you can start creating documents from inside SuperOffice.
  </Tab>

  <Tab title="SuperOffice 11.10 and older (Windows)">
    1. Go to <i class="ph ph-list" aria-label="Main menu" /> in the top bar.

    2. Select **Download** > **SuperOffice WebTools**.

       ![Download WebTools -screenshot][img2]

    3. In the SuperOffice WebTools wizard, select **Personal Computer** > **SuperOffice**, and click **Download** to download the installation file.

       ![WebTools installation -screenshot][img3]

       ![WebTools installation -screenshot][img4]

    4. Click **Next** and **Close** to close the WebTools wizard.

    5. Click the downloaded **SuperOffice.Web.Tools.exe** file in the downloads section in your browser.

    6. Click **Continue**.

    7. Click **Install**.

    8. If you are asked for your user name and password to install, enter them and click **Install Software**.

    9. When the message "The installation was successful" is displayed, close the dialog.

    10. Finally, log out of SuperOffice CRM, close the browser window. Then reopen your browser window to log in again.

    With WebTools installed, you can start creating documents from inside SuperOffice.
  </Tab>

  <Tab title="MacOS">
    1. Go to <i class="ph ph-list" aria-label="Main menu" /> in the top bar and select **Download** > **SuperOffice WebTools**.

    2. Open the file in **DiskImage** and drag the app-file into the *Application* folder on your Mac.

       ![Drag and drop the SuperOffice icon to the Applications folder -screenshot][img6]

    3. You are good to go.

    ### Optional setting for default start-up

    Add "SuperOffice WebTools" to your users' "Login Items" for it to start together with your Mac.

    ![Add SuperOffice WebTools into your Login Items to make the application appear automatically -screenshot][img7]

    ### Preferences

    Set the preferences to fit your needs:

    * Open and edit document directly from SuperOffice
      * Ask to check-in when done editing
      * Only upload on document close
    * Show alarms for follow-up in SuperOffice
    * Copy activities to iCal
      * Copy activities every \[x minutes]
      * Copy participants to Address Book
    * Copy contacts to Address Book
      * Copy contacts every \[x hours]
      * Copy contacts from one specific selection in SuperOffice

    ![Set the preferences to fit your needs -screenshot][img8]
  </Tab>
</Tabs>

## Upgrade

We are always working to improve our programs, including WebTools. When a new version of WebTools is available, you will get a notification when logging in. To install the new version, just follow the guide that appears on your screen.

## Technical information for administrators

WebTools currently uses .NET Framework 4.7.2, which will be installed if it is not detected on the system.

Administrative privileges are not required for the user. If you are not the administrator, you get WebTools installed in *c:\users\\\<yourname>\appdata\local\SuperOffice*.

### How configuration is passed in the file name

1. When you download WebTools from a SuperOffice installation, the downloaded file has a name in form of `SuperOffice.Web.Tools--u=https%3a%2f%2fsuperoffice%3a443%2fSuperOffice%2f&cn=SuperOffice&un=souser--.exe`. The contents after `--` is the configuration directive.

2. The WebTools installer executes the command (without brackets):

   `SuperOffice.TrayApp.Client.exe /autoconfig:[installer_name]`

**Example:**

This example configures the WebTools installation to connect to `https://superoffice/superoffice/`.

The full command given to *SuperOffice.TrayApp.Client.exe* in this example is:

`SuperOffice.TrayApp.Client.exe /autoconfig:"SuperOffice.Web.Tools--u=https%3a%2f%2fsuperoffice%3a443%2fSuperOffice%2f&cn=SuperOffice&un=souser--.exe"`

[1]: /en/email/inbox/learn/setup

[img2]: /media/loc/en/integrations/webtools/download-webtools.png

[img3]: /media/loc/en/integrations/webtools/webtools-pc.png

[img4]: /media/loc/en/integrations/webtools/webtools-email-client.png

[img6]: /media/loc/en/integrations/webtools/webtools-mac-install.jpg

[img7]: /media/loc/en/integrations/webtools/webtools-mac-login-items.jpg

[img8]: /media/loc/en/integrations/webtools/webtools-mac-preferences.jpg
