Unsplash Integration Administrator Setup | Communifire Documentation

Set up Unsplash integration on your intranet to unlock a library of beautiful, free images for your content. Unsplash images can be selected as featured images and can be added in content.

1. If you don't already have an Unsplash account, register for an account here.
2. Visit the API applications page.
3. Click New Application.
4. Check the Use and Guidelines terms.
5. Click Accept terms.
6. Enter an Application name. We recommend using your intranet name + "Integration". Don't use "Unsplash" in the name.
7. Enter a Description. (e.g. This application is used to add featured images and insert images in [intranet name].)
8. Click Create application.
9. In the Keys section, copy the Access Key and save it for later.
10. In Communifire, click the gear icon > Control Panel > System > System Properties.
11. Search for unsplash.
12. Edit UnsplashAccessKey.
13. Paste the access key you copied, then click Save.
14. Edit UnsplashDefaultSearchKeyword.
15. Enter a keyword. The keyword is used to display images when the Unsplash image selector is first opened. A keyword is required.
16. Click Save.
17. Edit UnsplashEnabledInImageUploader.
18. Set the value to true, then click Save.
19. Edit UnsplashAppName.
20. Enter your intranet name, then click Save.

Once you update system properties, users can select featured images from Unsplash. See Using Unsplash in Communifire .

Apply for Production-Level API Rates

By default, your Unsplash app allows 50 API requests/hour. You can apply for production access to increase this to 5,000 requests/hour.

1. If you didn't update the UnsplashAppName system property, follow the steps below. Otherwise, proceed to step 2.
   • In Communifire, click the gear icon > Control Panel > System > System Properties. 
   • Search for UnsplashAppName.
   • Click the edit icon.
   • Enter your intranet name.
   • Click Save.
   • Click Exit Control Panel.
2. Click Create > Space.
3. For Space name, enter Unsplash.
4. Enter a Space description.
5. For Type of space, select Private.
6. Set moderation to Yes.
7. Click Continue.
8. Click Save Settings.
9. In the space menu, click Articles.
   If you don't see Articles in the space menu, select a different content type: Blogs, Ideas, Calendar.
10. Click Add Article.
11. Click the featured image placeholder.
12. Click Unsplash.
13. Click any image.
14. Save the featured image.
15. Fill out the rest of the required fields: Headline, summary, article body, and parent category.
16. Click Save and Publish.
17. Attribution text appears in the upper right corner of the featured image. (ex: Photo by Annie Spratt on Unsplash). Hover over the photographer's name so that the link URL appears in the bottom of your browser.
18. Take a screenshot that includes the attribution text and link URL.
    • Windows: Press the Windows key + print screen. The screenshot is saved in the Pictures > Screenshots folder.
    • Mac: Press Cmd + Shift + 3. The screenshot is saved to your desktop.
      
      Example screenshot below. Both the attribution text and full link URL must be visible.
      
19. Visit the Unsplash API applications page.
20. Click your app.
21. In the Requests & Usage section, confirm that the Downloads count is greater than 0. If the downloads count is 0, wait 20 minutes then refresh the page.
22. In the Apply for production section, upload the screenshot.
23. Click Apply for production.

A confirmation email will be sent to the email address associated with the Unsplash account. When your app is approved, Unsplash will notify you via email. On the API applications page, your app's status will change to Production.

After approval, you can delete the Unsplash space.