> For the complete documentation index, see [llms.txt](https://docs.fylr.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fylr.io/tutorials/use-fylr-in-google-docs-via-ci-hub.md).

# Use fylr in Google docs via CI HUB

## Required

* Login to a fylr instance with permission to see some media content
  * This fylr needs to have the CI HUB capability in its fylr license. This is not part of all fylr licenses.
  * By default all fylr installations have the "OAuth client" named "ci-hub" configured, so this should not be an issue. However, during a fylr installation, this *could* theoretically be changed. If you have problems to connect CI HUB to fylr, consult the instances administrator.

## Setup

1. Open a Google document on <https://docs.google.com>
2. Open the `Extensions` menu and select `Get Add-ons`.
3. In this new dialog, search for `CI HUB` and install it. This will then happen automatically inside Google docs and not on your computer's local storage.
4. In the `Extensions` menu again, select `CI HUB Connector` and `Open`:<img src="/files/E3rWWz4MDgPIVQTqjGmx" alt="" data-size="original">
5. In the appearing panel (right hand side of the document) `Login` either with an existing CI HUB ID or `Register` for a free trial with CI HUB:

   <figure><img src="/files/yN9ASMbwB0SmsAVd9N4z" alt=""><figcaption></figcaption></figure>
6. After you logged in with your CI HUB ID, the side panel should change (you may have to re-open it).
7. In the CI HUB side panel, search for `fylr` and click the plus button (marked in green below):

   <figure><img src="/files/aFmut4Zd1LfoVIcVBXAR" alt=""><figcaption></figcaption></figure>
8. Enter any fylr URL (where you have a login) and click `Login`: ![](/files/CppcmcpS2Jmr3oTh0x3y)
9. Log in to the appearing fylr login dialog with your *fylr* credentials.
10. Go back to the Google document. In the side panel e.g. click on the magnifying glass.
11. Then click on the magnifying class *below the first one*, to search for any asset in fylr. Both magnifying glasses are marked in green here:

    <figure><img src="/files/5xnwF2oCKeP5DyuRV3UN" alt=""><figcaption></figcaption></figure>
12. If nothing is found, you may have to choose an Object Type in the drop down menu `Object Type`.
13. Click on one preview image once, then click on it a *2nd time* and **drag** it into your document before releasing the click.

Wait a few seconds for the transfer. (There is a spinning circle in the preview as long as CI HUB is working on it.)

### Known errors

* After clicking `Login` in Step 8:\ <mark style="color:red;">`Authorization failed`</mark>\ <mark style="color:red;">`Sorry, an unexpected error ocurred:`</mark>\ <mark style="color:red;">`TypeError: Cannot destructure property 'systemUrl' of '(intermediate value)' as it is undefined.`</mark>\
  \
  **When trying again a few minutes later, it worked.**
* When dragging an image from the CI HUB panel into the document:\ <mark style="color:red;">`Error: executePanelCommand failed: Exception: The image in the BlobSource could not be retrieved. Please make sure the image is valid.`</mark>\
  \
  Seems to be a kind of timeout with bigger images. **Did work when I tried it the 2nd time.**

## References

CI HUB official User Guide: <https://ci-hub.com/hubfs/CI%20HUB%20Connector%20User%20Guide%20v1.1.pdf>