Skip to main content


Content Analysis and Disambiguation


Let's choose as relevant entity in this example [Web], as the post is referring to the World Wide Web. As the entity type for [Web] is a Thing the entity appears under the what category.


Reconciling entities means linking the entity appearing in this text with its own equivalent on other sources (i.e. DBpedia or Freebase).


Using the WordLift Edit Post Widget you can now read the following parameters:

  • Entity Title the name of the entity
  • Entity Category the type of entity according to the vocabulary
  • Entity Description the description of the entity

All parameters but the Title can be edited directly from the [WordLift Edit Post Widget]


Data being used for the enrichments comes from openely avaialble sources like DBpedia that might contain misleading information that the editor can alwasy edit.

Entity properties can also be edited clicking on the "open in vocabulary" link (see Edit Entity page.)

Once you hit Save you are annotating this post which means adding a semantic fingerprint to this piece of content.

In this post another important entity worth mentioning is the creator of the World Wide Web Sir Tim Berners-Lee. The entity is properly identified as Person and all Person and Organization types are available under the who category.



Annotations are saved when a blog post or a page is published. Annotations and data related to each entity being annotated remain in draft untill the post is published.


When the text from the Visual Editor is edited or removed all annotations being saved are lost. WordLift stores the editor's selection of entities in the content of the Visual Editor.

Manual Entity Selection

If you are looking to annotate an entity that hasn’t been suggested by the semantic analysis you still can do it manually.

Here is how it works:

First select the entity that you want to annotate

  • Go to WordLift Edit Post Widget.
  • Click on Add.
  • Choose the entities that you want to annotate form the suggested list.


Adding Entities

The purpose of using WordLift is to (1) categorize your content, (2) help people find content of interest to them, and (3) help WordLift describe your contents in machine-readable format so that other computers can re-use it.

In some cases key concepts that are important for (1), (2) and (3) are not automatically detected by WordLift and need to be taught by creating new entities.


A basic guideline for adding entity is: people should apply entities the same way a librarian would plausibly use tags to classify the content you're writing if it was a book. For some basic guidelines on when creating new entities read here.

New entities being added will become part of the WordLift vocabulary.

Once an entity as been added to the vocabulary it will be automatically detected every-time you mention it again in your contents.

In our example one significant entity has not been detected and it is worth teaching it to WordLift.


The entity is [WordLift] itself. To create a new entity simply highlight the text WordLift, then click the button Create New Entity at the top of the [WordLift Edit Post Widget] and by clicking it you will be then able to edit the properties of the new entity.


Choose the category Creative Work (it also applies to Software), add a description and hit the "Save" button. Now the new entity will appear as related entities of the blog post along with [Web] and [Tim Berners-Lee].



When creating a new entity over an existing annotation: a) remove the annotated entity, b) re-write the entity and c) create a new one (as described above). See animation below.


Updating and Linking Entities

Updating the description

When we have something meaningful to say on a specific concept we shall curate the information and edit the data that has been fetched automatically by WordLift (this will create our own version of Wikipedia).

Linking other entities

Entity pages can be annotated just like you would do with a blog posts.

After saving the new description you wrote, WordLift will analyze the text and suggest related entities. You can now link an entity with other entities. WordLift will store these relationships between one entity and other entities in the graph using the Dublin Core property dct:related. This information will be used to infer new connections between the contents of the site. For more information on entity linking read the faq.

% Entities being linked are listed as Releated Entities in the editing screen of the entity. % % .. image:: /images/wordlift-content-analysis-new-entity-related-entity.png


You can add synonyms in WordLift for any entity. Synonyms are marked up in the structured data using the schema property alternateName . WordLift will automatically add the synonyms it knows for a given entity. WordLift also uses synonyms for its content analysis: if you want an entity to be detected in the future you shall add all the available synonyms (ie. “WWW” is a synonym for “World Wide Web” - capitalization will be ignored so “WWW” is the same as “www).

Entity Types

Here follows the list of properties that can be edited with WordLift for each entity type.
ThingThe most generic type of,description,image, type,URL,sameAs, additionalType.Thing
PersonA,description,image, type,URL,sameAs, additionalType.Person
PlaceEntities with a physical,description,image, type,URL,sameAs, additionalType,geo.Place
EventAn event happening in a specific time and,description,image, type,URL,sameAs, additionalType,location, startDate,endDate,performer, offers.Event
OfferAn,description,image, availability,price,URL, priceCurrency, availabilityStarts, availabilityEnds, inventoryLevel,validFrom, priceValidUntil,itemOffered.Offer
OrganizationAn,description,image, type,URL,sameAs, additionalType,founder.Organization
Local businessA physical business or branch of an,description,image, type,URL,sameAs,address founder,geo.LocalBusiness
Creative WorkThe most generic kind of Creative Work(i.e. Software).name,description,image, type,URL,sameAs, additionalType.CreativeWork
RecipeA food,description,image, type,URL,sameAs, additionalType, cookTime, prepTime, totalTime, recipeCuisine, recipeIngredient, recipeInstructions, recipeYield, author, nutrition.calories.Recipe