combinedListingUpdate

Add, remove and update CombinedListings of a given Product. CombinedListings are comprised of multiple products to create a single listing.

Use it in a workflow

Add a step and choose the Shopify connector.
Pick the combinedListingUpdate action (under Combined).
Fill in the fields below, then reference the result from later steps as {{combinedlistingupdate.response.data}}.

Query

This is the mutation the action sends by default. Edit it in the step's Query field to change which fields come back.

graphql

mutation CombinedListingUpdate($parentProductId: ID!, $title: String, $productsAdded: [ChildProductRelationInput!], $productsEdited: [ChildProductRelationInput!], $productsRemovedIds: [ID!], $optionsAndValues: [OptionAndValueInput!]) {
  combinedListingUpdate(
    parentProductId: $parentProductId
    title: $title
    productsAdded: $productsAdded
    productsEdited: $productsEdited
    productsRemovedIds: $productsRemovedIds
    optionsAndValues: $optionsAndValues
  ) {
    product {
      availablePublicationsCount {
        count
        precision
      }
      bodyHtml
      bundleConsolidatedOptions {
        name
        selections
      }
      category {
        ancestorIds
        childrenIds
        fullName
        id
        isArchived
        isLeaf
        isRoot
        level
        name
        parentId
      }
      combinedListing {
        parentProduct
      }
      combinedListingRole
      compareAtPriceRange {
        maxVariantCompareAtPrice
        minVariantCompareAtPrice
      }
      createdAt
      customProductType
      defaultCursor
      descriptionHtml
      descriptionPlainSummary
      featuredImage {
        altText
        height
        id
        originalSrc
        src
        thumbhash
        width
      }
      featuredMedia {
        alt
        id
        mediaContentType
        mediaErrors
        mediaWarnings
        preview
        status
      }
      feedback {
        appFeedback
        details
        summary
      }
      giftCardSettings {
        crossCurrencyRedeemable
        issuanceCurrency
      }
      giftCardTemplateSuffix
      handle
      hasOnlyDefaultVariant
      hasOutOfStockVariants
      hasVariantsThatRequiresComponents
      id
      isGiftCard
      legacyResourceId
      mediaCount {
        count
        precision
      }
      onlineStorePreviewUrl
      onlineStoreUrl
      priceRange {
        maxVariantPrice
        minVariantPrice
      }
      priceRangeV2 {
        maxVariantPrice
        minVariantPrice
      }
      productCategory {
        productTaxonomyNode
      }
      productComponentsCount {
        count
        precision
      }
      productType
      publishedAt
      publishedOnCurrentChannel
      publishedOnCurrentPublication
      requiresSellingPlan
      resourcePublicationOnCurrentPublication {
        isPublished
        publication
        publishDate
        publishable
      }
      sellingPlanGroupCount
      sellingPlanGroupsCount {
        count
        precision
      }
      seo {
        description
        title
      }
      standardizedProductType {
        productTaxonomyNode
      }
      status
      storefrontId
      tags
      templateSuffix
      title
      totalInventory
      totalVariants
      tracksInventory
      updatedAt
      variantsCount {
        count
        precision
      }
      vendor
    }
    userErrors {
      code
      field
      message
    }
  }
}

Variables

Pass these as a JSON object in the step's Variables field.

parentProductIdstringrequired

The ID of the parent product.

titlestring

The updated title for the combined listing.

productsAddedarray<object>

The child products to add and their assigned options and option values.

childProductIdstringrequired

selectedParentOptionValuesarray<string>required

productsEditedarray<object>

The child products to edit and their assigned options and option values.

childProductIdstringrequired

selectedParentOptionValuesarray<string>required

productsRemovedIdsarray<string>

The IDs of products to be removed from the combined listing.

optionsAndValuesarray<object>

The ordered options and values to be used by the combined listing. Options and values will be reordered to match the order specified here.

namestringrequired

valuesarray<string>required

optionIdstring

linkedMetafieldobject3 fields

json

{
  "parentProductId": "string",
  "title": "string",
  "productsAdded": [
    {
      "childProductId": "string",
      "selectedParentOptionValues": [
        "string"
      ]
    }
  ],
  "productsEdited": [
    {
      "childProductId": "string",
      "selectedParentOptionValues": [
        "string"
      ]
    }
  ],
  "productsRemovedIds": [
    "string"
  ],
  "optionsAndValues": [
    {
      "name": "string",
      "values": [
        "string"
      ],
      "optionId": "string",
      "linkedMetafield": {
        "namespace": "string",
        "key": "string",
        "values": "string"
      }
    }
  ]
}

Response

Read the result with {{combinedlistingupdate.response.data.data.combinedListingUpdate}}. If the API returns errors, the step fails and they are at {{combinedlistingupdate.response.data.errors}}.

productobject

availablePublicationsCountobject2 fields

bodyHtmlstring

bundleConsolidatedOptionsarray<object>

categoryobject10 fields

combinedListingobject1 fields

combinedListingRolestring

One ofPARENTCHILD

compareAtPriceRangeobject2 fields

createdAtstring

customProductTypestring

defaultCursorstring

descriptionHtmlstring

descriptionPlainSummarystring

featuredImageobject7 fields

featuredMediaobject7 fields

feedbackobject3 fields

giftCardSettingsobject2 fields

giftCardTemplateSuffixstring

handlestring

hasOnlyDefaultVariantboolean

hasOutOfStockVariantsboolean

hasVariantsThatRequiresComponentsboolean

idstring

isGiftCardboolean

legacyResourceIdstring

mediaCountobject2 fields

onlineStorePreviewUrlstring

onlineStoreUrlstring

priceRangeobject2 fields

priceRangeV2object2 fields

productCategoryobject1 fields

productComponentsCountobject2 fields

productTypestring

publishedAtstring

publishedOnCurrentChannelboolean

publishedOnCurrentPublicationboolean

requiresSellingPlanboolean

resourcePublicationOnCurrentPublicationobject4 fields

sellingPlanGroupCountnumber

sellingPlanGroupsCountobject2 fields

seoobject2 fields

userErrorsarray<object>

codeobject

fieldobject

messageobject

Need more? See the Shopify guide for connection setup and behaviour shared by every action.

Was this page helpful?