Linked Web Storage Vocabulary

W3C Group Note Draft

More details about this document
This version:
https://www.w3.org/TR/2026/DNOTE-lws10-vocab-20260714/
Latest published version:
https://www.w3.org/TR/lws10-vocab/
Latest editor's draft:
https://w3c.github.io/lws-protocol/lws10-vocab/
History:
https://www.w3.org/standards/history/lws10-vocab/
Commit history
Editors:
Jesse Wright (University of Oxford)
Erich Bremer (Stony Brook University)
Author:
Laurens Debackere (Digitaal Vlaanderen)
Feedback:
GitHub w3c/lws-protocol (pull requests, new issue, open issues)

Abstract

This document describes the Linked Web Storage Vocabulary, i.e., the RDFS [RDF-SCHEMA] vocabulary used by the Linked Web Storage Protocol [lws-core].

Alternate versions of the vocabulary definition exist in Turtle and JSON-LD.

Published:
Version Info:
1.0
See Also:
https://www.w3.org/TR/lws-protocol/

Status of This Document

This section describes the status of this document at the time of its publication. A list of current W3C publications and the latest revision of this technical report can be found in the W3C standards and drafts index.

This vocabulary has been defined by the W3C Linked Web Storage Working Group and provides the official RDFS vocabulary for the Linked Web Storage Protocol. Comments regarding this document are welcome. Please file issues directly on GitHub.

This document was published by the Linked Web Storage Working Group as a Group Note Draft using the Note track.

Group Note Drafts are not endorsed by W3C nor its Members.

This is a draft document and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to cite this document as other than a work in progress.

The W3C Patent Policy does not carry any licensing requirements or commitments on this document.

This document is governed by the 18 August 2025 W3C Process Document.

1. Conformance

As well as sections marked as non-normative, all authoring guidelines, diagrams, examples, and notes in this specification are non-normative. Everything else in this specification is normative.

2. Namespaces

This specification makes use of the following namespaces:

lws
https://www.w3.org/ns/lws#
as
https://www.w3.org/ns/activitystreams#
schema
http://schema.org/
sec
https://w3id.org/security#
ldp
http://www.w3.org/ns/ldp#
dc
http://purl.org/dc/terms/
owl
http://www.w3.org/2002/07/owl#
rdf
http://www.w3.org/1999/02/22-rdf-syntax-ns#
rdfs
http://www.w3.org/2000/01/rdf-schema#
xsd
http://www.w3.org/2001/XMLSchema#

3. @context files

The following @context files make use of the terms defined in this specification:

4. Term definitions

4.1 Property definitions

The following are property definitions in the lws namespace.

4.1.1 items

items

The list of resources contained in a container.
Domain:
Container
Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.2 totalItems

total items

The total number of items in a container.
Note

This term is formally defined in another vocabulary (as as:totalItems), but is frequently used with this vocabulary and has been included to aid readability of this document.

Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.3 mediaType

media type

The media type of a data resource.
Note

This term is formally defined in another vocabulary (as as:mediaType), but is frequently used with this vocabulary and has been included to aid readability of this document.

Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.4 updated

modified

The date and time the resource was last modified.
Note

This term is formally defined in another vocabulary (as as:updated), but is frequently used with this vocabulary and has been included to aid readability of this document.

Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.5 size

size

The size of the resource in bytes.
Note

This term is formally defined in another vocabulary (as schema:size), but is frequently used with this vocabulary and has been included to aid readability of this document.

Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.6 capability

capability

A capability supported by the storage.
Domain:
Storage
Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.7 service

service

A service associated with the storage.
Domain:
Storage
Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.8 serviceEndpoint

service endpoint

The URI of a service endpoint.
Range:
xsd:anyURI
Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.9 storageDescription

storage description

Link relation pointing to a storage description resource.
Range:
xsd:anyURI
Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.10 PreferLinkRelations

Prefer Link Relations

A preference URI for including or omitting specific link relations in responses.
Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.11 subscriptionType

subscription type

See the formal definition of the term.

The subscription types supported by a notification service.
Domain:
NotificationService
Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.12 subscription

subscription

See the formal definition of the term.

The URL of the subscription resource or connection endpoint.
Range:
xsd:anyURI
Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.13 activity

activity

See the formal definition of the term.

The Activity Streams 2.0 activity payload within a notification.
Domain:
Notification
Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.14 topic

topic

See the formal definition of the term.

An array of resource URIs covered by a subscription.
Range:
xsd:anyURI
Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.15 storage

storage

See the formal definition of the term.

The URI identifying the LWS storage that emitted the notification.
Range:
xsd:anyURI
Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.16 Create

Create

An activity representing the creation of a resource.
Note

This term is formally defined in another vocabulary (as as:Create), but is frequently used with this vocabulary and has been included to aid readability of this document.

Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.17 Update

Update

An activity representing the update of a resource.
Note

This term is formally defined in another vocabulary (as as:Update), but is frequently used with this vocabulary and has been included to aid readability of this document.

Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.18 Delete

Delete

An activity representing the deletion of a resource.
Note

This term is formally defined in another vocabulary (as as:Delete), but is frequently used with this vocabulary and has been included to aid readability of this document.

Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.19 object

object

The primary object of an activity.
Note

This term is formally defined in another vocabulary (as as:object), but is frequently used with this vocabulary and has been included to aid readability of this document.

Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.20 actor

actor

The agent that performed the activity.
Note

This term is formally defined in another vocabulary (as as:actor), but is frequently used with this vocabulary and has been included to aid readability of this document.

Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.21 target

target

The target of the activity.
Note

This term is formally defined in another vocabulary (as as:target), but is frequently used with this vocabulary and has been included to aid readability of this document.

Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.22 origin

origin

The origin of a Move activity.
Note

This term is formally defined in another vocabulary (as as:origin), but is frequently used with this vocabulary and has been included to aid readability of this document.

Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.23 published

published

The date and time the activity was published.
Note

This term is formally defined in another vocabulary (as as:published), but is frequently used with this vocabulary and has been included to aid readability of this document.

Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.24 verificationMethod

verification method

A verification method associated with a key or identity.
Note

This term is formally defined in another vocabulary (as sec:verificationMethod), but is frequently used with this vocabulary and has been included to aid readability of this document.

Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.25 authentication

authentication

An authentication method associated with an identity.
Note

This term is formally defined in another vocabulary (as sec:authentication), but is frequently used with this vocabulary and has been included to aid readability of this document.

Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.26 controller

controller

The entity that controls a verification method.
Note

This term is formally defined in another vocabulary (as sec:controller), but is frequently used with this vocabulary and has been included to aid readability of this document.

Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.27 publicKeyJwk

public key JWK

A public key expressed as a JSON Web Key.
Note

This term is formally defined in another vocabulary (as sec:publicKeyJwk), but is frequently used with this vocabulary and has been included to aid readability of this document.

Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.28 inbox

inbox

A URL to which notifications are delivered via HTTP POST.
Note

This term is formally defined in another vocabulary (as ldp:inbox), but is frequently used with this vocabulary and has been included to aid readability of this document.

Relevant @context:
https://www.w3.org/ns/lws/v1

4.1.29 expires

expires

The date and time at which a subscription expires.
Note

This term is formally defined in another vocabulary (as schema:expires), but is frequently used with this vocabulary and has been included to aid readability of this document.

Relevant @context:
https://www.w3.org/ns/lws/v1

4.2 Class definitions

The following are class definitions in the lws namespace.

4.2.1 Container

Container

A resource that contains other resources.
Domain of:
items, totalItems
Relevant @context:
https://www.w3.org/ns/lws/v1

4.2.2 DataResource

Data Resource

A data-bearing resource such as a document, image, or structured data file.
Domain of:
mediaType, updated, size
Relevant @context:
https://www.w3.org/ns/lws/v1

4.2.3 Storage

Storage

A Linked Web Storage instance.
Domain of:
capability, service
Relevant @context:
https://www.w3.org/ns/lws/v1

4.2.4 StorageDescription

Storage Description

A service that provides a storage description resource.
Relevant @context:
https://www.w3.org/ns/lws/v1

4.2.5 OpenIdProvider

OpenID Provider

See the formal definition of the term.

An OpenID Connect identity provider service.
Relevant @context:
https://www.w3.org/ns/lws/v1

4.2.6 Notification

Notification

See the formal definition of the term.

A notification envelope describing an event that occurred on a resource.
Domain of:
activity
Relevant @context:
https://www.w3.org/ns/lws/v1

4.2.7 NotificationService

Notification Service

See the formal definition of the term.

A service through which clients subscribe to resource change notifications.
Domain of:
subscriptionType
Relevant @context:
https://www.w3.org/ns/lws/v1

4.2.8 WebhookSubscription

Webhook Subscription

See the formal definition of the term.

A subscription type that delivers notifications via HTTP POST to a subscriber-provided inbox URL.
Relevant @context:
https://www.w3.org/ns/lws/v1

A. References

A.1 Informative references

[lws-core]
Linked Web Storage Protocol 1.0. Jesse Wright; Erich Bremer. W3C. 22 June 2026. W3C Working Draft. URL: https://www.w3.org/TR/lws10-core/
[RDF-SCHEMA]
RDF Schema 1.1. Dan Brickley; Ramanathan Guha. W3C. 25 February 2014. W3C Recommendation. URL: https://www.w3.org/TR/rdf-schema/