Overview
Glean's CSV upload feature allows administrators to hide documents at scale. This method can be especially helpful for organizations that may need to manage the visibility of thousands of documents efficiently so that they do not display in Glean's search results and Assistant responses. By using a CSV file, admins can specify which documents to hide, and from whom.
Up to 500,000 documents can be specified in the CSV file. It will take about an hour to hide the documents, and they will remain hidden unless you delete the CSV file or upload a new one.
Step 1: Prepare your CSV file
In the left nav, click the wrench icon to access the admin console. Then, go to Governance > Document hiding and click "Download the CSV template."
The first column of the CSV should contain the unique Glean document identifier (document ID), and the second column should specify the preferred visibility:
Column 1 | Column 2 |
Document ID | Preferred visibility:
|
How to find the Glean document ID
Search for the document
Hover on the search result to copy the document ID
Step 2: Upload your CSV file
Once your CSV file is ready, upload it to Glean. The system will validate the file data and execute when all validation checks pass.
Important notes
Only one CSV is active at any time.
Deleting the uploaded CSV unhides all documents.
The active CSV needs to always contain all the document IDs that need to be hidden, not just the updates between edits. As an example:
An admin uploads a CSV with 10 document IDs that need to hidden from all.
If the admin wants to hide 2 more document IDs, the new CSV must contain 12 entries (including the original 10 and the 2 new entries).
Similarly, if the admin wants to unhide 10 documents out of the 12, leaving only 2 documents hidden, they must upload a CSV that contains 2 rows; one row for each of the documents that should be hidden.
At this time, we are unable to hide non-documents, e.g. folders or containers.
Hiding documents via CSV upload only changes the visibility in Glean’s search results and Assistant responses. It does not change the source permissions of the document.
Errors
During upload, Glean performs checks on the CSV file to ensure the format and data are correct. Admins will be notified of the errors, if any.
All errors must be resolved for the CSV upload to succeed. As an example:
If an admin uploads a CSV with 100 entries and 2 errors are discovered, none of the 100 docs will be hidden until the CSV is corrected and all errors are resolved.