Setting up Helpjuice as a Source

👥
Access Required
Guru Access: You need to be an Admin, Source Creator, or relevant custom role to set up Sources.
Helpjuice Access: You need an admin-level API key from your Helpjuice account to authenticate the connection.

Setting up Helpjuice as a Source

In Guru, go to Manage.
Select Sources, then click Add Source.
Choose Helpjuice from the list of integrations.
Enter your Helpjuice API key (admin-level token).
Provide your Helpjuice subdomain.
Select your language preference from the list of available languages.
Choose your permission settings:
- Respect Helpjuice permissions: Guru will honor the access levels set in Helpjuice
- Manage permissions in Guru: Control access using Guru Groups regardless of Helpjuice settings
Select which article types to sync (Public, Internal, or both).
Add a display name for the Source (optional) and click Connect Source.
Assign which Guru Groups should have access to this content.

The initial sync will begin immediately and may take several minutes depending on the size of your Helpjuice knowledge base.

✍
Note
For native permissions to work properly, user email addresses must be visible to your organization in Helpjuice and Guru.

What gets synced from Helpjuice

Primary objects are the objects used to generate the search record.

Primary Object: Article Content	Metadata	Access Levels
Article title	Article URL	Public articles
Full article body	Category information	Internal articles
Formatting and structure	Language settings	Deep links to articles

✍️
Note
Private articles are not synced. The Helpjuice API does not provide access control information for Private articles, so Guru cannot determine who should have access to them. Only Public and Internal articles will sync to Guru.

Permission options explained

When setting up your Helpjuice Source, you have two options for managing who can access the synced content:

Respect Helpjuice permissions: Guru will mirror the access levels from Helpjuice. Users will only see content they have permission to view in Helpjuice. This requires that user email addresses match between both systems.
Manage permissions in Guru: You control access entirely through Guru Groups, independent of Helpjuice permissions. This is useful if you have limited Helpjuice seats but want broader access to knowledge in Guru.

Frequently asked questions about Helpjuice

Why aren't my Private articles syncing? The Helpjuice API doesn't expose access control details for Private articles, so Guru cannot determine which users should have access to them. Only Public and Internal articles will sync to your Guru workspace.

Can I sync content in multiple languages? Yes, you can select your preferred language during setup. Guru supports 50 popular languages for Helpjuice content. If your language isn't listed, contact Guru support to have it added.

Can I filter which Helpjuice content syncs to Guru? Currently, you can choose to sync Public articles, Internal articles, or both. More granular filtering options, including category-level syncing, are being developed.