> For the complete documentation index, see [llms.txt](https://docs.hotwax.co/documents/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hotwax.co/documents/learn-shopify/troubleshooting-reference/shopify-solr-search.md).

# Shopify Solr Search

Troubleshoot missing or unexpected files in Shopify Solr Search.

Shopify Solr Search lists bulk-operation files, including preorder-tag and catalog JSON files that are prepared for Shopify updates. Use it to confirm that the expected file was created and to narrow the result set before investigating the related Shopify job.

## Before you begin

You need the `SHOPIFY_VIEW` permission to open `Shopify Solr Search`. The page searches the Shopify Solr core and filters results by source, operation, and created date.

## Find the expected file

1. Open `Shopify Solr Search` from the Shopify menu.
2. Set a created-date range that includes the expected file-generation time.
3. Use the `Source` filter to select the process that created the file.
4. Use the `Operation` filter to narrow the results to the expected Shopify update.
5. Review the matching file name, operation, source, and timestamp.

## Resolve common issues

### No file is listed

First, remove the filters and expand the date range. If the file is still missing, confirm that the job or bulk operation that creates the preorder-tag or catalog JSON file completed successfully. Correct the job failure before expecting a file to appear in `Shopify Solr Search`.

### The file is older than expected

Compare the file timestamp with the latest job run. HotWax Commerce only regenerates the file when the related bulk operation runs again. Run or schedule the appropriate job, then return to `Shopify Solr Search` and filter by the new timestamp.

### The file content does not match the expected update

Confirm that you selected the correct source and operation. Then review the source data and job configuration that produced the file. Do not manually edit the Solr result; correct the source data or configuration and regenerate the file through the related job.

### You cannot open the page

Ask an administrator to grant the `SHOPIFY_VIEW` permission. `Shopify Solr Search` does not display results without `SHOPIFY_VIEW` access.


---

# 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://docs.hotwax.co/documents/learn-shopify/troubleshooting-reference/shopify-solr-search.md?ask=<question>&goal=<user_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.