Schema: agent

Action JSON-LD example for the parent type behind all schema.org activity verbs. Covers the 7 Action properties (agent, object, participant, startTime, endTime, location, result), the Action state values (PotentialActionStatus, ActiveActionStatus, CompletedActionStatus, FailedActionStatus), and how Action subtypes attach to entities as potentialAction or subjectOf.

AchieveAction JSON-LD example for completing a certification. AchieveAction is the parent of WinAction, LoseAction, and TieAction for actions that result in an accomplishment.

AssessAction JSON-LD example for evaluating a product. AssessAction is the parent of ReviewAction, ChooseAction, and ReactAction for actions that evaluate or judge something.

ConsumeAction JSON-LD example for reading an article. ConsumeAction is the parent of ViewAction, WatchAction, ReadAction, ListenAction, PlayAction, UseAction, EatAction, DrinkAction, and InstallAction.

ControlAction JSON-LD example for activating a subscription. ControlAction is the parent of ActivateAction, DeactivateAction, ResumeAction, and SuspendAction for lifecycle actions on services and devices.

CreateAction JSON-LD example for writing a blog post. CreateAction is the parent of WriteAction, PhotographAction, DrawAction, FilmAction, CookAction, and PaintAction for actions that produce a CreativeWork.

FindAction JSON-LD example for tracking a shipment. FindAction is the parent of CheckAction, DiscoverAction, and TrackAction for actions that locate or monitor something.

InteractAction JSON-LD example for registering for a course. InteractAction is the parent of CommunicateAction, FollowAction, JoinAction, LeaveAction, MarryAction, RegisterAction, BefriendAction, and SubscribeAction for social and community actions.

MoveAction JSON-LD example for traveling between cities. MoveAction is the parent of TravelAction, ArriveAction, and DepartAction for movement between places.

OrganizeAction JSON-LD example for bookmarking a product. OrganizeAction is the parent of AllocateAction, ApplyAction, BookmarkAction, and PlanAction for actions that arrange or schedule something.

PlayAction JSON-LD example for a live concert performance. PlayAction is the parent of PerformAction and ExerciseAction for actions with entertainment or recreational value.

SolveMathAction JSON-LD example for solving an equation. SolveMathAction is used on math education content to express the act of solving a problem, paired with eduQuestionType.

TradeAction JSON-LD example for a purchase. TradeAction is the parent of BuyAction, SellAction, OrderAction, PayAction, DonateAction, RentAction, TipAction, PreOrderAction, and QuoteAction for commerce actions.

TransferAction JSON-LD example for downloading a file. TransferAction is the parent of BorrowAction, DownloadAction, GiveAction, LendAction, MoneyTransfer, ReceiveAction, ReturnAction, SendAction, and TakeAction for actions that move something between parties.

UpdateAction JSON-LD example for adding a product to a cart. UpdateAction is the parent of AddAction, DeleteAction, and ReplaceAction for actions that modify a collection or entity.

ExerciseAction JSON-LD example for a running session — a PlayAction subtype describing exertive activity for health and fitness. Carries exerciseType, distance, sportsActivityLocation, exerciseCourse, exercisePlan, sportsEvent, opponent, and the diet/exerciseRelatedDiet pairing.

CommunicateAction JSON-LD example — the parent of AskAction, CheckInAction, CheckOutAction, CommentAction, InformAction, InviteAction, ReplyAction, and ShareAction. Carries recipient, about, language, and inLanguage.

DonateAction JSON-LD example for a charitable gift. TransferAction subtype carrying price, priceCurrency, priceSpecification, and recipient — used in email receipts and charity-platform action markup.

CookAction JSON-LD example for preparing a recipe. CreateAction subtype linking to a Recipe, a FoodEvent, or a FoodEstablishment — used in cooking activity streams and recipe execution markup.

RsvpAction JSON-LD example for an event RSVP in Gmail markup. Carries rsvpResponse (Yes/No/Maybe), additionalNumberOfGuests, and comment — the canonical form for Gmail confirm-your-attendance action cards.

WriteAction JSON-LD reference — CreateAction subtype with language and inLanguage. For authoring activity streams.

ChooseAction JSON-LD reference — AssessAction subtype with option / actionOption. Parent of VoteAction.

VoteAction JSON-LD reference — ChooseAction subtype with candidate. For casting a vote in an election.

ReplaceAction JSON-LD reference — UpdateAction subtype with replacee and replacer. Used in activity streams for version replacement.

RentAction JSON-LD reference — TradeAction subtype with landlord and realEstateAgent. Renting a property or vehicle.

SellAction JSON-LD reference — TradeAction subtype with buyer and warrantyPromise. Selling a product or service.

PayAction JSON-LD reference — TradeAction subtype with recipient. Transferring money to a recipient.

TipAction JSON-LD reference — TradeAction subtype with recipient. Voluntary payment for service.

SendAction JSON-LD reference — TransferAction subtype with recipient and deliveryMethod. Sending an object.

ReceiveAction JSON-LD reference — TransferAction subtype with sender and deliveryMethod. Receiving an object.

TrackAction JSON-LD reference — FindAction subtype with deliveryMethod. Tracking an Order / shipment.

ReturnAction JSON-LD reference — TransferAction subtype with recipient. Returning a purchased item.

GiveAction JSON-LD reference — TransferAction subtype with recipient. Giving an object without compensation.

LendAction JSON-LD reference — TransferAction subtype with borrower. Lending an object.

BorrowAction JSON-LD reference — TransferAction subtype with lender. Mirror of LendAction.

LeaveAction JSON-LD reference — InteractAction subtype with event. Leaving an event / organization / community.

JoinAction JSON-LD reference — InteractAction subtype with event. Joining an event / group.

FollowAction JSON-LD reference — InteractAction subtype with followee. Following a person on a social platform.

AskAction JSON-LD reference — CommunicateAction subtype with question. Asking a question.

ReplyAction JSON-LD reference — CommunicateAction subtype with resultComment. Replying to a comment or post.

CommentAction JSON-LD reference — CommunicateAction subtype with resultComment. Posting a top-level comment.

InviteAction JSON-LD reference — CommunicateAction subtype with event. Inviting someone to an event.

InformAction JSON-LD reference — CommunicateAction subtype with event. Informing someone about an event (parent of RsvpAction and ConfirmAction).

AuthorizeAction JSON-LD reference — AllocateAction subtype with recipient. Granting permission to a recipient.

EndorseAction JSON-LD reference — ReactAction subtype with endorsee. Publicly endorsing a Person / CreativeWork.

PlanAction JSON-LD reference — OrganizeAction subtype with scheduledTime. Planning a future action.

ReviewAction JSON-LD reference — AssessAction subtype with resultReview. Producing a Review.

PerformAction JSON-LD reference — PlayAction subtype with entertainmentBusiness. For a performance at a venue.

TravelAction JSON-LD reference — MoveAction subtype with distance. Traveling some distance.

WinAction JSON-LD reference — AchieveAction subtype with loser. Winning a competition.

LoseAction JSON-LD reference — AchieveAction subtype with winner. Mirror of WinAction.