> For the complete documentation index, see [llms.txt](https://learn.mechanic.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.mechanic.dev/platform/liquid/mechanic-code-snippets.md).
# Mechanic code snippets
A list of convenience snippets provided in the Mechanic code editor.
### `bulk_operation_query` - GraphQL bulk operation query template
This snippet expands to provide a complete template for initiating a bulk operation query and responding to the results (see [Bulk operations](/core/shopify/bulk-operations.md)). Use it from the top level of a new task after defining the task option fields.
Once the snippet is selected, you will be prompted to select a resource name, which must be in camel case (e.g. `productVariant`). You can type in your own resource name if it doesn't appear in the list. This value will be propagated throughout most of the snippet block.
Hitting `tab` after choosing the initial resource name, you will again be prompted to choose a resource name, this time to be used within the sample JSONL preview block and the resource assignment by `__typename` afterwards. This resource name needs to be in Pascal case to align with Shopify resource identifiers (e.g. `ProductVariant`).
***
### `gid` - Shopify global ID
Expands inline to provide an example [gid](https://shopify.dev/docs/api/usage/gids) with the resource object you choose. You may also type your resource object if there is not a match in the list.
This snippet is most useful when generating stub/preview data for a GraphQL query.
***
### `object_query` - GraphQL object query
This snippet can be used when you want to query a single top-level resource in GraphQL.
Once the snippet is selected, you will be prompted to select a resource name, which must be in camel case (e.g. `productVariant`). You can type in your own resource name if it doesn't appear in the list. This value will be propagated throughout most of the snippet block.
Hitting `tab` after choosing the initial resource name, you will again be prompted to choose a resource name, this time only for use within the sample preview block. This resource name needs to be in Pascal case to align with Shopify resource identifiers (e.g. `ProductVariant`).
***
### `paginated_query` - GraphQL paginated query
Use this snippet to provide a paginated query for a resource within a for loop block. It will prompt you to choose the resource type.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://learn.mechanic.dev/platform/liquid/mechanic-code-snippets.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
