---
title: Hugo+ Integration
slug: editorial/hugo-integration
docTags: 
createdAt: 2026-04-13T06:32:03.328Z
---

:::BlockQuote
**ℹ️ Note:** The Hugo+ Integration requires [Purple DAM Plus](docId\:q2-fG1Ax3roq7tZttHRmp).
:::

## What is Hugo Plus Integration?

The Hugo Plus integration connects your Purple Hub media library with your organization's huGO+ Digital Asset Management (DAM) system. This allows you to search, browse, and import images from huGO+ directly within Purple Hub, and export your Purple Hub images back to huGO+ - all without leaving your editor.

**Key Benefits:**

- Search and browse huGO+ images without switching systems
- Import images with all their metadata intact (captions, copyright, keywords, etc.)
- Export Purple Hub images to huGO+ with one click
- Streamline your publishing workflow

***

## Getting Started

### Prerequisites

Before you can use the Hugo Plus integration, you'll need:

1. An active huGO+ account
2. Your huGO+ API credentials (URL and access tokens)
3. Have [Purple DAM Plus](docId\:q2-fG1Ax3roq7tZttHRmp) enabled in you Purple Hub
4. Administrator access to configure the integration

### Initial Setup

1. **Navigate to Integration Settings**
   - Go to **Settings -> Media → Integrations** 
2. **Enable the Integration**
   - Activate the toggle for Hugo to enable Hugo Plus integration
3. **Enter Your Credentials**
   - **HugoPlus URL:** Enter your huGO+ system URL
   - **HugoPlus Token:** Enter your authentication token
   - **Picture API Token:** Enter your picture upload token
4. **Integration check**
   - The system will automatically test your connection
   - You'll see a success message if everything is configured correctly

***

## Using Hugo Plus

### Searching and Browsing Images

1. **Open the Media Library**
   - Go to **Media **or in the editor on an image block, click "Add Media".
2. **Select Hugo Plus**
   - In the "Sources" section click the "Hugo+" chip to switch to images that come from huGO+
3. **Search for Images**
   - Use the search bar to find images by keywords
   - Apply filters to narrow your results:
     - Date range
     - Custom Hugo+ filters (if configured in the integration settings)
4. **Browse Results**
   - Images appear as thumbnails with titles
   - The newest images appear first
   - Use pagination to view more results

### Importing Images from Hugo Plus

**Method 1: From Media Library**

1. Find an image using search/browse (see above)
2. Click the image thumbnail to open the detail view
3. Review the image metadata
4. Click the **"Import"** button
5. The image is now available in your Purple Hub media library

:::hint{type="info"}
Please note: Only the import of web formats is supported at the moment. Print formats like .tiff can not be supported
:::

**Method 2: From Article Editor**

1. While editing an article, search for a huGO+ image
2. Select the image you want to use
3. Click **"Insert"**
4. The image is automatically imported to Purple Hub and added to your article

**What Gets Imported?:**

- The image file (highest quality available)
- Title and description
- Caption and alt text
- Metadata fields (copyright, keywords, etc. as long as they are supported by the Hub)

### Exporting Images to Hugo Plus

1. **Upload an Image**
   - Upload a new image to Purple Hub
2. **Enable Export to Hugo**
   - Check the **"Export to huGO+"** checkbox (enabled by default)
3. **Select Export Channel**
   - Choose the destination channel in huGO+
4. **Save the Image**
   - Click "Save"
   - The image is automatically uploaded to huGO+

***

## Settings and Configuration

### Connection Settings

**HugoPlus URL**

- The web address of your huGO+ system
- Example format: `https://your-hugo-system.com`

**HugoPlus Token**

- Your authentication token for accessing huGO+
- Keep this secure and don't share it

**Picture API Token**

- Special token for uploading images to huGO+
- Different from your main token

**Enable Hugo Integration**

- Toggle this on to activate the integration
- Toggle off to temporarily disable without losing your settings

### Filter Configuration

- Select custom fields that should be available as search filters
- These appear alongside standard filters (date, category, source)

***

## Common Workflows

### Workflow 1: Finding and Using a Stock Photo

1. Open the article editor
2. Click "Add Media"
3. Switch to "Hugo+" tab
4. Search for "landscape sunset"
5. Apply filters: Date = "Last 30 days", Type = "Photo"
6. Click desired image
7. Click "Insert into Article"
8. Image is imported and inserted automatically

### Workflow 2: Publishing Local Images to Hugo

1. Upload photos from your event to Purple Hub
2. Check "Export to huGO+" box
3. Select export channel: "Editorial"
4. Click "Save"
5. Images are now available in huGO+ for your entire organization

***

## Tips and Best Practices

### For Better Search Results

- **Use specific keywords:** "Berlin marathon 2025" instead of just "sport"
- **Apply filters:** Narrow by date range when looking for recent content
- **Check categories:** Use category filters to find themed content quickly
- **Browse sources:** Filter by photographer or agency for consistent style

***

## Troubleshooting

### "Hugo integration is not configured"

**Problem:** The integration isn't set up yet.

**Solution:**

1. Go to **Settings -> Media → Integrations**
2. Enter your huGO+ credentials
3. Check "Enable Hugo integration"
4. Click "Save Changes"

### "Connection test failed"

**Problem:** Purple Hub can't connect to your huGO+ system.

**Solutions:**

- Verify your HugoPlus URL is correct
- Check that your tokens haven't expired
- Contact your administrator to verify your huGO+ account is active

### Images not appearing in search

**Problem:** You know an image exists in huGO+ but it doesn't show up in search.

**Solutions:**

- Check your spelling
- Try broader search terms
- Remove filters that might be excluding the image