Choose a version:

Anchor to collectionConditionsSourceUpdate

collectionConditionsSourceUpdate

mutation

Requires write_products access scope. Also: The app must have access to the input fields used to update a collection source. Further, the store must not be on the Starter or Retail plans and the user must have permission to manage products.

Updates a shareable collection source owned by the calling app.

Anchor to Arguments

Arguments

Anchor to inputinput

•CollectionUpdateConditionsSourceInput!

required

The input fields for the source to update.

Show input fields

Was this section helpful?

Anchor to CollectionConditionsSourceUpdatePayload returnsCollectionConditionsSourceUpdatePayload returns

Anchor to sourcesource •CollectionConditionsSource: The updated collection source.

Show fields
Anchor to userErrorsuserErrors •[UserError!]! non-null: The list of errors that occurred from executing the mutation.

Show fields

Was this section helpful?

Examples

Update a shareable collection source

Description

Update the details of a shareable collection source owned by the calling app.

Query

mutation CollectionConditionsSourceUpdate($input: CollectionUpdateConditionsSourceInput!) {
  collectionConditionsSourceUpdate(input: $input) {
    source {
      id
      title
      description
    }
    userErrors {
      field
      message
    }
  }
}

Variables

{
  "input": {
    "id": "gid://shopify/CollectionConditionsSource/129168209",
    "title": "Updated spring source",
    "description": "Updated products to include in spring collections."
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-07/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation CollectionConditionsSourceUpdate($input: CollectionUpdateConditionsSourceInput!) { collectionConditionsSourceUpdate(input: $input) { source { id title description } userErrors { field message } } }",
 "variables": {
    "input": {
      "id": "gid://shopify/CollectionConditionsSource/129168209",
      "title": "Updated spring source",
      "description": "Updated products to include in spring collections."
    }
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation CollectionConditionsSourceUpdate($input: CollectionUpdateConditionsSourceInput!) {
    collectionConditionsSourceUpdate(input: $input) {
      source {
        id
        title
        description
      }
      userErrors {
        field
        message
      }
    }
  }`,
  {
    variables: {
        "input": {
            "id": "gid://shopify/CollectionConditionsSource/129168209",
            "title": "Updated spring source",
            "description": "Updated products to include in spring collections."
        }
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation CollectionConditionsSourceUpdate($input: CollectionUpdateConditionsSourceInput!) {
    collectionConditionsSourceUpdate(input: $input) {
      source {
        id
        title
        description
      }
      userErrors {
        field
        message
      }
    }
  }
QUERY

variables = {
  "input": {
    "id": "gid://shopify/CollectionConditionsSource/129168209",
    "title": "Updated spring source",
    "description": "Updated products to include in spring collections."
  }
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation CollectionConditionsSourceUpdate($input: CollectionUpdateConditionsSourceInput!) {
      collectionConditionsSourceUpdate(input: $input) {
        source {
          id
          title
          description
        }
        userErrors {
          field
          message
        }
      }
    }`,
    "variables": {
        "input": {
            "id": "gid://shopify/CollectionConditionsSource/129168209",
            "title": "Updated spring source",
            "description": "Updated products to include in spring collections."
        }
    },
  },
});

Shopify CLI

shopify app execute \
--query \
'mutation CollectionConditionsSourceUpdate($input: CollectionUpdateConditionsSourceInput!) {
  collectionConditionsSourceUpdate(input: $input) {
    source {
      id
      title
      description
    }
    userErrors {
      field
      message
    }
  }
}' \
--variables \
'{
  "input": {
    "id": "gid://shopify/CollectionConditionsSource/129168209",
    "title": "Updated spring source",
    "description": "Updated products to include in spring collections."
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-07/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      mutation CollectionConditionsSourceUpdate($input: CollectionUpdateConditionsSourceInput!) {
        collectionConditionsSourceUpdate(input: $input) {
          source {
            id
            title
            description
          }
          userErrors {
            field
            message
          }
        }
      }
    `,
    variables: {
        "input": {
            "id": "gid://shopify/CollectionConditionsSource/129168209",
            "title": "Updated spring source",
            "description": "Updated products to include in spring collections."
        }
    },
  }),
});

const { data } = await response.json();
console.log(data);

Response

{
  "collectionConditionsSourceUpdate": {
    "source": {
      "id": "gid://shopify/CollectionConditionsSource/129168209",
      "title": "Updated spring source",
      "description": "Updated products to include in spring collections."
    },
    "userErrors": []
  }
}

collectionConditionsSourceUpdate reference

Examples

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(

`#graphql

mutation CollectionConditionsSourceUpdate($input: CollectionUpdateConditionsSourceInput!) {

collectionConditionsSourceUpdate(input: $input) {

source {

title

description

}

userErrors {

field

message

}

}`,

{

variables: {

"input": {

"id": "gid://shopify/CollectionConditionsSource/129168209",

"title": "Updated spring source",

"description": "Updated products to include in spring collections."

}

);

const json = await response.json();

return json.data;

}

GQL

mutation CollectionConditionsSourceUpdate($input: CollectionUpdateConditionsSourceInput!) {
  collectionConditionsSourceUpdate(input: $input) {
    source {
      id
      title
      description
    }
    userErrors {
      field
      message
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-07/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation CollectionConditionsSourceUpdate($input: CollectionUpdateConditionsSourceInput!) { collectionConditionsSourceUpdate(input: $input) { source { id title description } userErrors { field message } } }",
 "variables": {
    "input": {
      "id": "gid://shopify/CollectionConditionsSource/129168209",
      "title": "Updated spring source",
      "description": "Updated products to include in spring collections."
    }
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation CollectionConditionsSourceUpdate($input: CollectionUpdateConditionsSourceInput!) {
    collectionConditionsSourceUpdate(input: $input) {
      source {
        id
        title
        description
      }
      userErrors {
        field
        message
      }
    }
  }`,
  {
    variables: {
        "input": {
            "id": "gid://shopify/CollectionConditionsSource/129168209",
            "title": "Updated spring source",
            "description": "Updated products to include in spring collections."
        }
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation CollectionConditionsSourceUpdate($input: CollectionUpdateConditionsSourceInput!) {
      collectionConditionsSourceUpdate(input: $input) {
        source {
          id
          title
          description
        }
        userErrors {
          field
          message
        }
      }
    }`,
    "variables": {
        "input": {
            "id": "gid://shopify/CollectionConditionsSource/129168209",
            "title": "Updated spring source",
            "description": "Updated products to include in spring collections."
        }
    },
  },
});

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation CollectionConditionsSourceUpdate($input: CollectionUpdateConditionsSourceInput!) {
    collectionConditionsSourceUpdate(input: $input) {
      source {
        id
        title
        description
      }
      userErrors {
        field
        message
      }
    }
  }
QUERY

variables = {
  "input": {
    "id": "gid://shopify/CollectionConditionsSource/129168209",
    "title": "Updated spring source",
    "description": "Updated products to include in spring collections."
  }
}

response = client.query(query: query, variables: variables)

Shopify CLI

shopify app execute \
--query \
'mutation CollectionConditionsSourceUpdate($input: CollectionUpdateConditionsSourceInput!) {
  collectionConditionsSourceUpdate(input: $input) {
    source {
      id
      title
      description
    }
    userErrors {
      field
      message
    }
  }
}' \
--variables \
'{
  "input": {
    "id": "gid://shopify/CollectionConditionsSource/129168209",
    "title": "Updated spring source",
    "description": "Updated products to include in spring collections."
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-07/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      mutation CollectionConditionsSourceUpdate($input: CollectionUpdateConditionsSourceInput!) {
        collectionConditionsSourceUpdate(input: $input) {
          source {
            id
            title
            description
          }
          userErrors {
            field
            message
          }
        }
      }
    `,
    variables: {
        "input": {
            "id": "gid://shopify/CollectionConditionsSource/129168209",
            "title": "Updated spring source",
            "description": "Updated products to include in spring collections."
        }
    },
  }),
});

const { data } = await response.json();
console.log(data);

Input variables

JSON

{

"input": {

"id": "gid://shopify/CollectionConditionsSource/129168209",

"title": "Updated spring source",

"description": "Updated products to include in spring collections."

}

Response

JSON

{

"collectionConditionsSourceUpdate": {

"source": {

"id": "gid://shopify/CollectionConditionsSource/129168209",

"title": "Updated spring source",

"description": "Updated products to include in spring collections."

"userErrors": []

}