--- title: "Resources" description: "Add texts, files, web pages and websites, follow their import status, re-index them and stay within your plan's word allowance." canonical: "https://lookio.app/docs/guides/resources" updated: "2026-11-08" --- # Resources A resource is a piece of knowledge, stored once. Any assistant can read it. **Resources** lists them all. Filter by tag, type or status, and open a resource to edit it. ![The Resources page with Ready, Indexing, Words stored and Pages counters, filters, and a table of resources with PDF, DOC, XLS, URL, TEXT and SITE icons](/docs/images/app/resources-list.webp) _Resources: the counters at the top, then one row per resource with its format, tags and status._ ## Add a resource Choose **Add a resource**, then pick a tab: **Files**, **Web page**, **Sitemap** (a whole website) or **Text**. ![The Add a resource dialog: Files, Web page, Sitemap and Text tabs, a drop zone, Tags and Source fields](/docs/images/app/resources-add.webp) | You add | What happens | Guide | | ---------------- | --------------------------------------------------------------------------- | ----------------------------------------- | | **Text** tab | Lookio indexes what you paste. | Below | | **Files** tab | Each file becomes a resource. Lookio reads it with a reader for its format. | [File formats](/docs/guides/file-formats) | | **Web page** tab | Each address becomes a resource. Lookio reads it as a visitor sees it. | [Websites](/docs/guides/websites) | | **Sitemap** tab | One resource. Lookio reads its pages and keeps them in sync. | [Websites](/docs/guides/websites) | ### Text Paste text or Markdown, up to 100,000 characters. Lines that start with `#` become the sections that answers cite. Give a long text real headings. The title is part of every passage that Lookio indexes. Write a clear title: "Refund policy 2026" is found more easily than "Notes". ### Fields on every resource - **Title.** Up to 200 characters. - **Tags.** Up to 30, each up to 60 characters. See [Tags](/docs/guides/tags). - **Source.** Optional, up to 500 characters. A URL or a mention such as "Employee handbook, 2026 edition". Lookio shows it with every citation of the resource. An empty value clears it. See [Citations](/docs/guides/citations). ## Statuses Lookio creates the resource at once, then reads and indexes it in the background. A page or a short file takes seconds. A site takes minutes. ```mermaid title="The life of a resource" stateDiagram-v2 direction LR [*] --> queued queued --> processing processing --> ready processing --> failed ready --> stale: the source changed stale --> processing: re-index failed --> processing: re-index ready --> processing: re-index or sync ``` | Status in the API | Shown in the app | Meaning | | ----------------- | ----------------- | -------------------------------------------- | | `queued` | Indexing | Waiting to be read. | | `processing` | Indexing | Being read and indexed. | | `ready` | Ready | Searchable. Assistants can answer from it. | | `failed` | Failed | Could not be read. `status_detail` says why. | | `stale` | Needs re-indexing | Out of date. Re-index it. | `ready` and `failed` are final. Poll until one of them appears, then stop. ![The sheet of a failed web page resource, with the reason circled: The page answered 404 Not Found. Check the address, then re-read the page.](/docs/images/app/resource-failed.webp) _A failed resource says why, under its status._ An assistant answers only from `ready` resources. It skips a resource that is not ready, without an error. A question asked too early can get no answer. ## Re-index Open a resource, then its **⋯** menu. The re-index action is named after the type of the resource. ![The menu of a resource sheet: Re-index, See indexing logs, Documentation and Delete resource](/docs/images/app/resource-menu.webp) | Type | Re-index | | -------- | ------------------------------------------------------------------------------------------------------------------------------------ | | Text | Indexes the current text again. | | File | Reads the stored original again. Nothing is uploaded twice. | | Web page | Fetches the page again. The action is called **Re-read page**. | | Website | Syncs the site. Lookio adds new pages, reads changed pages again and removes pages that are gone. The action is called **Sync now**. | Re-indexing is free. During a re-index, assistants keep searching the current version. The new version replaces it only when it is complete. Lookio also re-indexes a text when you edit it, and a file when you rename it, because the title is part of every passage. Re-index after a failure, or when the source changed. A website that syncs each week rarely needs it. ## Read what was indexed Open a resource, then **View the text**. You see the text in Markdown, as assistants search it, up to 200,000 characters. You also see what Lookio could not read, such as pages without readable text. Check an import this way before you rely on it. ![The sheet of the PDF resource Pricing and plans 2026: status Ready, type File, file name with 6 pages, tags and dates](/docs/images/app/resource-file.webp) _The sheet of a file: its status, file name and number of pages._ ## Word allowance Your plan caps the number of words Lookio stores for the workspace. | Plan | Words stored | | ------- | -------------- | | Free | 125,000 | | Starter | 1,000,000 | | Pro | 10,000,000 | | Custom | No fixed limit | Lookio counts the words of every `ready` resource. A word is a run of letters or digits. In a CSV over 2 MB, a row that holds only figures and codes counts as one word, because it is computed but not stored for search. At the limit, Lookio refuses to add or re-index, with this message: "Your plan's limit of 125,000 words stored is reached. Delete resources or upgrade your plan to add more." The API error code is `request_too_large_for_plan`. If a resource passes the limit during indexing, it fails with the same message in `status_detail`. Delete resources you do not need, or change plan. See [Credits and plans](/docs/get-started/credits-and-plans). ## Pages read each month Each plan also includes a number of pages read per calendar month (UTC). | Plan | Pages per month | | ------- | --------------- | | Free | 200 | | Starter | 1,500 | | Pro | 15,000 | | Custom | No fixed limit | A page is one PDF page, one image or slide that OCR reads, or one web page, at import or during a site sync. Text, Markdown, CSV, spreadsheets and Word files never count. Only new or changed content counts. A page that did not change since the last sync is not read again. Past the limit, an admin buys extra pages on **Billing**, by 1,000. They never expire. Lookio uses the plan's pages first. The **Pages this month** counter on the Resources page shows your use. ## From the API, the CLI and MCP **API** [List resources](/docs/api/resources/list-resources), [Create a resource](/docs/api/resources/create-resource), [Add a file](/docs/api/resources/upload-file), [Get a resource's content](/docs/api/resources/get-resource-content), [Re-index](/docs/api/resources/reindex-resource). **CLI** ```bash lookio resources list --tag billing lookio resources add-file ./handbook.pdf --tags hr lookio resources reindex RESOURCE_ID ``` See [CLI commands](/docs/developers/cli/commands). **MCP** `add_text_resource`, `add_web_page`, `get_resource` and more. See [MCP tools](/docs/developers/mcp/standard-tools).