Skip to content

Bizzkit plugins

To integrate Bizzkit products like PIM, DAM, and Ecommerce Search with your CMS and enhance the Builder.io user interface, you need to install the Bizzkit plugins.

Registering plugins

Plugins must be registered within a space in Builder.io before they are available to users. This can be done by navigating to the settings of the desired space and then, within the Integrations category, clicking "Edit" under Plugins:

Plugin registration

Plugin registration

Next, insert the URLs for each plugin you wish to include and save:

Plugin registration

Plugin registration

The URLs for the Bizzkit products are as follows:

1
2
3
4
5
6
https://{CompanyName}-content.bizzkit.cloud/plugins/dam-file.system.js
https://{CompanyName}-content.bizzkit.cloud/plugins/ecs-dynamic-products.system.js
https://{CompanyName}-content.bizzkit.cloud/plugins/ecs-products.system.js
https://{CompanyName}-content.bizzkit.cloud/plugins/pim-brand.system.js
https://{CompanyName}-content.bizzkit.cloud/plugins/pim-categories.system.js
https://{CompanyName}-content.bizzkit.cloud/plugins/content-hub.system.js?pluginId=@bizzkit/content-hub

Editor plugins

The plugins offered by Bizzkit are of a type called "Editor plugin". This means they can be used as field types in Builder.io models:

Selecting Bizzkit types

Selecting Bizzkit types

When creating new content for your model, the custom field editor will display for entering data into the field:

Using the Bizzkit types

Using the Bizzkit types

Using plugins with custom components

Similar to data models, editor plugins can also be used as input types in custom components:

Using plugins in custom components

Using plugins in custom components

This ensures that users can only select values provided by the plugin integration, while offering an easy-to-use interface.

Reference

The plugins can be referenced by their respective type names and contain their own payload formats as described below. Note that only certain plugins can be used as targeting attributes.

DAM
  • Type: Bizzkit DAM File
  • Payload:
1
2
3
4
5
{
  "fileId": string,
  "croppingId": null | string,
  "filePath": string
}
  • Targeting attribute: No
Ecommerce Search product
  • Type: Bizzkit ECS Product
  • Payload:
1
2
3
4
{
  "id": string,
  "segmentId": string
}
  • Targeting attribute: No
Ecommerce Search product list
  • Type: Bizzkit ECS Product List
  • Payload:
1
2
3
4
5
6
[
  {
    "id": string,
    "segmentId": string
  }
]
  • Targeting attribute: No
PIM brand
  • Type: Bizzkit PIM Brand
  • Payload:
string // The brand's system/unique name
  • Targeting attribute: Yes
PIM product category
  • Warning: This plugin is deprecated in version 25 and will be removed in version 26. Use PIM product category targeting instead.
  • Type: Bizzkit PIM Categories
  • Payload:
1
2
3
4
{
  "id": string,
  "systemName": string
}
  • Targeting attribute: No
PIM product category targeting
  • Type: Bizzkit PIM Categories Targeting
  • Payload:
string // The product category systemName
  • Targeting attribute: Yes

UI plugins

Another type of plugin is a plugin used to enhance the Builder.io user interface with additional functionality. For example, the Bizzkit Content Hub plugin adds a new tab to the Builder.io sidebar:

Content Hub plugin

Content Hub plugin

For more information about the Content hub plugin, see the Content Hub documentation.