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

# Install the Word add-in

> Deploy Casa Conect for Word to your whole organization from the Microsoft 365 admin center, or add it to a single computer.

Casa Conect for Word is distributed as an **add-in manifest**: a small file that tells Word where the add-in lives. Your Microsoft 365 administrator can deploy it to everyone at once, which is the recommended route, or an individual can add it to a single computer.

<Note>
  Ask [support@casaconect.ai](mailto:support@casaconect.ai) for the current manifest file. You need an active Casa Conect OS subscription to use the add-in.
</Note>

## Before you start

* A supported version of Word. See [Where it runs](/word-add-in/overview#where-it-runs).
* A Casa Conect account in an organization with Casa Conect OS.
* For organization-wide deployment, a Microsoft 365 **Global Administrator** or **Exchange Administrator**.

## Deploy to your organization (recommended)

Centralized deployment puts the **Casa Conect** button on everyone's *Home* tab. Users install nothing, and updates arrive automatically.

<Steps>
  <Step title="Open Integrated apps">
    In the [Microsoft 365 admin center](https://admin.microsoft.com), go to **Settings → Integrated apps** and choose **Upload custom apps**.
  </Step>

  <Step title="Upload the manifest">
    Choose **Office Add-in** as the app type, then **Upload manifest file (.xml) from device**, and select the Casa Conect manifest. Microsoft validates it on upload.
  </Step>

  <Step title="Choose who gets it">
    Assign it to **Everyone**, to specific **users or groups**, or to **just yourself** to try it first.
  </Step>

  <Step title="Accept the permission request and deploy">
    The add-in requests **read and write access to the current document**. Review this, then choose **Finish deployment**.
  </Step>

  <Step title="Wait for it to appear">
    Microsoft says an add-in can take up to 24 hours to appear for all users, although it is usually much quicker. Restarting Word helps.
  </Step>
</Steps>

## Add it to one computer

<Tabs>
  <Tab title="Word on the web">
    1. Open a document in Word on the web.
    2. Choose **Home → Add-ins → More Add-ins → My Add-ins → Upload My Add-in**.
    3. Select the manifest file and choose **Upload**.
  </Tab>

  <Tab title="Word for Mac">
    1. Quit Word.
    2. Copy the manifest file into `~/Library/Containers/com.microsoft.Word/Data/Documents/wef`. Create the `wef` folder if it does not exist.
    3. Open Word, then choose **Home → Add-ins** and pick **Casa Conect** under *Developer Add-ins*.

    On recent versions of macOS this folder method is unreliable. If the add-in does not appear, ask your administrator to use centralized deployment.
  </Tab>

  <Tab title="Word for Windows">
    On Windows, adding a manifest by hand requires a shared network folder registered as a *trusted add-in catalog* in **File → Options → Trust Center → Trust Center Settings → Trusted Add-in Catalogs**. This is awkward for an individual to set up. We recommend centralized deployment instead.
  </Tab>
</Tabs>

## Sign in

<Steps>
  <Step title="Open the panel">
    On the **Home** tab, choose **Casa Conect**. The panel opens with *Welcome to Casa Conect*.
  </Step>

  <Step title="Choose Sign in">
    A dialog opens with your normal Casa Conect sign-in. Enter your email address and the code you receive, and your authenticator code if you use one.
  </Step>

  <Step title="Return to Word">
    When the dialog says *"Signed in. You can close this window."*, it closes and the panel is ready.
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="This version of Office can't complete sign-in securely">
    Your copy of Office cannot verify where the sign-in dialog's messages come from, so the add-in refuses to continue rather than accept a sign-in it cannot trust. **Update Office** and try again.
  </Accordion>

  <Accordion title="Sign-in didn't complete">
    The dialog was closed before it finished, or a pop-up blocker interfered. Choose **Sign in** again. On Word on the web, allow pop-ups for the page.
  </Accordion>

  <Accordion title="The Casa Conect button is missing">
    If it was deployed centrally, wait, then restart Word. Check with your administrator that you are included in the assignment. On an iPad the add-in is not available.
  </Accordion>

  <Accordion title="The panel is blank or shows an error">
    Your network may block the add-in's address. Ask your IT team to allow the Casa Conect hosts and the sign-in provider. [Support](/get-started/get-help) can supply the list.
  </Accordion>
</AccordionGroup>

## Remove the add-in

* **Centrally deployed:** an administrator removes it under **Integrated apps**.
* **Added to one computer:** remove it from **My Add-ins**, or delete the manifest from the `wef` folder on a Mac.

Removing the add-in deletes nothing in Casa Conect. To end the add-in's access to your account, sign out from the panel's menu, or end its session under **Settings → Security → Sessions**.