DocumentationJourney OptimizerJourney Optimizer Guide

Work with Browsing integrations Browsing

Last update: October 6, 2026

CREATED FOR:

  • Beginner
  • User

On this page: Learn how administrators configure Browsing integrations that let marketers search, browse, and select items from external APIs directly in the authoring experience, and how to link them to Standard integrations.

style
shade-box

In addition to Standard integrations, you can create Browsing integrations. A Browsing integration lets marketers search, browse, and paginate through items returned by an external API, then select a specific item directly in the authoring experience instead of manually entering a parameter value.

Create a Browsing integration create-browsing

As an administrator, you create a Browsing integration from the Browsing tab of the Integrations configuration, using the same step-by-step instructions as for Standard integrations.

Once the integration information is provided, configure the following Browsing-specific settings:

  1. From the Items configuration menu, choose the Items path where the list of items is located.

    Items configuration menu with the Items path field selected {modal="regular"}

  2. In the Search configuration drop-down, Enable search and select which parameter carries the search query, then provide a description for marketers.

    Search configuration with Enable search toggled on and a search parameter selected {modal="regular"}

  3. In the Pagination configuration menu, enable Pagination and choose a pagination type:

    accordion
    Offset

    Configure the following fields to set up Offset pagination:

    • Total path: Provide the path to the total result count in the response body.

    • Offset parameter: Specify the request parameter that indicates the number of items to skip.

    • Limit parameter: Specify the request parameter that indicates the number of items to return.

    • Page size: Set the number of items to request per page.

      Offset pagination fields including Total path, Offset parameter, Limit parameter, and Page size {modal="regular"}

    accordion
    Page

    Configure the following fields to set up Page pagination:

    • Total path: Provide the path to the total result count in the response body.

    • Page parameter: Specify the request parameter that indicates the page number.

    • Page size parameter: Specify the request parameter that indicates the number of items per page.

    • Page size: Set the number of items to request per page.

    • First page is: Select whether the first page in the sequence is numbered 0 or 1.

    • Total pages path: Provide the path to the total page count in the response body. Optional if you’ve provided the total count path.

      Page pagination fields including Total path, Page parameter, Page size parameter, and First page is {modal="regular"}

    accordion
    Cursor

    Configure the following fields to set up Cursor pagination:

    • Total path: Provide the path to the total result count in the response body.

    • Cursor parameter: Specify the request parameter that carries the cursor value.

    • Limit parameter: Specify the request parameter that indicates the number of items to return.

    • Page size: Set the number of items to request per page.

    • Next cursor source: Select where the next cursor value is read from in the response.

    • Next cursor path: Provide the path to the next cursor value in the response body.

      Cursor pagination fields including Total path, Cursor parameter, and Next cursor path {modal="regular"}

  4. From the Render menu, choose how items are displayed to marketers:

    accordion
    Table

    For each column, choose the Label and the Data path. Optionally, select Quick map to add several fields as columns at once.

    You can reorder columns as needed, or select delete to remove a column.

    Table render configuration with Label and Data path defined for each column {modal="regular"}

    accordion
    List

    Fill in the following details:

    • Primary path: Provide the data key for the main label of each item.
    • Secondary path: Specify the data key for the subtitle.
    • Tag path: Specify the data key for the tag badge.

    List render configuration with Primary path, Secondary path, and Tag path fields {modal="regular"}

    accordion
    Avatar

    Fill in the following details:

    • Name path: Specify the data key for the display name shown below the avatar.
    • Image path: Specify the data key for the avatar image URL.
    • Description path: Provide the data key for the subtitle shown below the name.

    Avatar render configuration with Name path, Image path, and Description path fields {modal="regular"}

  5. Click Test browsing to preview the search and pagination behavior with the configured settings.

  6. Save the Browsing integration, then click Publish and Activate.

Once a Browsing integration is created, you can link it to a parameter on a Standard integration so marketers can select values through the Browsing selector instead of entering them manually.

  1. While configuring a parameter on a Standard integration, enable Browsing.

  2. Choose the Browsing integration to link.

    Enable browsing option linking a Browsing integration to a Standard integration parameter {modal="regular"}

  3. Save and publish the Standard integration.

Select items during authoring select-Browsing-items

When a parameter is linked to a Browsing integration, marketers can pick its value from a selector in the message or journey editor, rather than typing it manually.

  1. Access your campaign content and click Add personalization from your Text or HTML Components.

    Learn more on components

    Add personalization option in the Text or HTML component {modal="regular"}

  2. Navigate to the Integrations section and click Open integrations to view all active integrations.

    Integrations section with the Open integrations option in the content editor {modal="regular"}

  3. Select an integration.

  4. Search and browse the paginated list of items returned by the Browsing integration, then select an entity and confirm your selection.

    The corresponding Reference path value is then automatically inserted into the integration parameter.

    Browsing integration item selector with search and pagination in the content editor {modal="regular"}

  5. Click Save.

See also

recommendation-more-help
journey-optimizer-help