Open Graph

Open Graph controls how the exported document looks when it is shared in messengers, social networks, internal portals, and other link preview systems.

What Open Graph affects

When someone sends a link to the exported page, many platforms try to build a preview card from meta tags in the HTML head.

In One File Docs, these values are taken from the document Open Graph settings during export and written into the final file.

  • og:title defines the preview title
  • og:description defines the preview text
  • og:image defines the preview image
  • og:image:alt defines alternative text for that image
  • og:type is exported as article
  • og:locale is exported from the document language

The export also writes matching Twitter tags for title, description, and image so the same content can be reused by platforms that rely on Twitter metadata.

How to fill the fields

Use a short, clear title that matches the specific document being shared, not the name of the whole product or department.

Keep the description focused on the practical value of the page: what the reader will learn, do, or find after opening it.

Use a fully qualified public URL for the image, including https://. Relative paths or local files will not work reliably in external preview crawlers.

Add image alt text when the image contains important meaning, labels, metrics, or UI fragments that should be described accessibly.

How export uses these values

The Open Graph fields are inserted into the generated single HTML file. They do not change the visible page body, but they change what external services see before the page is opened.

If a field is empty, the exported preview becomes less predictable because different platforms may fall back to the page title, ignore the image, or build a reduced card.

Because image generation is disabled, the preview image must be prepared separately and hosted at a stable URL before publishing.

Practical recommendations

  • prepare one preview image per important document or release, not one generic image for everything
  • avoid text-heavy images that become unreadable in small cards
  • keep the title and description aligned with the current exported version
  • after publishing, test the shared link in the platforms that matter to your team
  • if the preview does not refresh immediately, remember that many services cache Open Graph data for some time