# webPixelUpdate - admin-graphql - MUTATION Version: 2024-07 ## Description Activate a [web pixel extension](https://shopify.dev/docs/apps/build/marketing-analytics/build-web-pixels) by updating a web pixel record on the store where you installed your app. When you run the `webPixelUpdate` mutation, Shopify validates it against the settings definition in `shopify.extension.toml`. If the `settings` input field doesn't match the schema that you defined, then the mutation fails. Learn how to define [web pixel settings](https://shopify.dev/docs/apps/build/marketing-analytics/build-web-pixels#step-2-define-your-web-pixel-settings). ### Access Scopes `write_pixels` access scope. Also: The app requires read_customer_events access scope and user access permission. ## Arguments * [id](/docs/api/admin-graphql/2024-07/scalars/ID): ID! - The ID of the web pixel to update. * [webPixel](/docs/api/admin-graphql/2024-07/input-objects/WebPixelInput): WebPixelInput! - The web pixel settings in JSON format. ## Returns * [userErrors](/docs/api/admin-graphql/2024-07/objects/ErrorsWebPixelUserError): ErrorsWebPixelUserError! The list of errors that occurred from executing the mutation. * [webPixel](/docs/api/admin-graphql/2024-07/objects/WebPixel): WebPixel The updated web pixel settings. ## Examples