# Known Issues¶

This document will collect some of the various issues we have encounter in publishing the JSON-LD documents.

### control characters in URL string for sitemap or in the JSON-LD documents¶

Make sure there are no control characters such as new line, carriage returns, tabs or others in the document. These can be problematic both for processing and display.

### context is a map (changed from 1.0)¶

Be sure to use a context style like:

    "@context": {
"@vocab": "https://schema.org/"
},


The context section must be a map starting in JSON-LD 1.1

### data graphs need @id¶

Be sure to include an @id in your graph that points to the identifier or the web address of the resource providing the metadata. This is not the material the metadata is about, but rather the metadata record itself.

### string literals must be valid¶

The string literals must be sure to not have quotation marks or other invalid characters without escaping or encoding them.