# GIPHY GIF integration

This page documents the server-level configuration required to enable
GIPHY integration to [add GIFs in your message][help-center-giphy] on
a self-hosted Zulip server.

To enable this integration, you need to get a production API key from
[GIPHY](https://developers.giphy.com/).

## Apply for API key

1. [Create a GIPHY account](https://giphy.com/join).

1. Create a GIPHY API Key by clicking “Create an App” on the
   [Developer Dashboard][giphy-dashboard].

1. Choose **SDK** as product type and click **Next Step**.

1. Enter a name and a description for your app and click on **Create
   New App**.  The hostname for your Zulip server is a fine name.

1. You will receive a beta API key. Apply for a production API key
   by following the steps mentioned by GIPHY on the same page.

You can then configure your Zulip server to use GIPHY API as
follows:

1. In `/etc/zulip/settings.py`, enter your GIPHY API key as
   `GIPHY_API_KEY`.

   GIPHY API keys are not secrets -- GIPHY expects every browser or
   other client connecting to your Zulip server will receive a copy --
   which is why they are configured in `settings.py` and not
   `zulip-secrets.conf`.

1. Restart the Zulip server with
   `/home/zulip/deployments/current/scripts/restart-server`.

Congratulations!  You've configured the GIPHY integration for your
Zulip server.

[giphy-dashboard]: https://developers.giphy.com/dashboard/