Add custom content

Custom content lets you add search results that do not come from your normal site crawl. Use it for help articles, hosted files, external resources, or other records that should be searchable through the same search interface.

File format

Upload a .jsonl or .ndjson file. Each line must be one JSON object.

Every record needs:

1. title
2. url
3. content

description is optional. You can also supply image_url when the record has a hosted image.

For example:

{"title":"Service hours","url":"https://help.example.com/hours","description":"When support is available","content":"# Service hours\n\nSupport is available Monday through Friday from 9:00 to 17:00."}
{"title":"Returns policy","url":"https://policies.example.net/returns","content":"# Returns\n\nReturns are accepted within 30 days when the item is unused.\n\n## Conditions\n\n- The item must be unused.\n- Keep the original receipt."}

The content field supports Markdown. Use headings, paragraphs, lists, and code blocks to keep long records structured. SearchCue splits that Markdown into meaningful search sections before indexing.

URLs and images

The url can point to your site or to a page on another domain. It must start with http:// or https://.

image_url is optional and follows the same rule. If you need an image, host it at an HTTPS URL and use that URL in the record.

Upload limits

The maximum upload size is 50 MB. Each record can be up to 256 KB.

These field limits also apply:

1. title: 300 characters
2. description: 1,000 characters
3. content: 50,000 characters
4. url and image_url: 4,096 characters

Rows that do not pass validation are rejected, but valid rows in the same file are still accepted.

Replacement behavior

Each successful upload replaces the previous custom content set for the site. You cannot browse individual uploaded rows inside SearchCue.

If an upload has no valid rows, the previous custom content stays active. If you abort an upload, the previous custom content also stays active.

You can delete all active custom content from the Custom content page.

Item limits

Custom content counts toward the same item limit as crawled pages. If your plan allows 1,000 items and you upload 200 custom records, SearchCue keeps room for up to 800 crawled page records.

When custom content and a crawled page use the same url, the custom content record is used for that URL.

Troubleshooting

If a row is rejected, check the row number shown after upload. The most common causes are missing title, missing url, missing content, an unsupported URL scheme, duplicate URLs in the same file, or records that are too large.

If your records upload but do not appear in search immediately, make sure the site has already completed at least one crawl. Custom content becomes searchable after SearchCue can rebuild the site index.