Math Solver Schema — Route Math Expressions to Your Solver
Generate MathSolver JSON-LD with a SolveMathAction, mathExpression-input, and the LearningResource fields Google's math solver docs require.
Try the Math Solver GeneratorWhat is MathSolver structured data?
MathSolver markup describes a tool that solves math problems and tells Google how to call it. The key part is a SolveMathAction: a URL template with a placeholder that Google fills with the user's math expression (for example x^2-3x=0), sending the user to your solution page.
Google's docs model it as two types at once: ["MathSolver", "LearningResource"]. The LearningResource part needs learningResourceType set to the fixed value Math Solver.
Required properties (per Google)
url: the URL of the math solver.usageInfo: the privacy policy for your solver site.learningResourceType: the fixed valueMath Solver.potentialAction: aSolveMathActionwith:target: the URL template, such ashttps://www.example.com/solve?q={math_expression_string}.mathExpression-input:required name=math_expression_string. The name must match the placeholder intarget.
Recommended properties
inLanguage: the language or languages your solver supports.eduQuestionType(on the action): the problem types your solver handles, such asPolynomial EquationorDerivative. Google publishes an example list of problem types and notes it isn't exhaustive.assesses: the problem type, when the MathSolver accompanies a HowTo that walks through a specific problem.
Google's guidelines to know
- Add the MathSolver structured data to your site's home page.
- If the same solver is hosted at several URLs, use canonical URLs on each copy.
- The solver can't be entirely behind a login or paywall: the solution and step-by-step walkthrough for the user's first problem must be accessible. Extra content can be gated.
- You are responsible for the accuracy of the problem types you declare and of your solutions. Google says solvers with inaccurate data may be removed from the feature.
How to build one here
- 01
Enter the solver name and your home page URL.
- 02
Add your privacy policy URL (usageInfo).
- 03
Enter the solve URL template with a {placeholder}; the generator uses the same name in mathExpression-input.
- 04
List the problem types your solver handles, one per line.
- 05
Copy the JSON-LD into your home page and test it in Google’s Rich Results Test.
Common errors and fixes
- Placeholder mismatch: the name in
mathExpression-inputmust match the{placeholder}intarget. - Missing LearningResource: use
["MathSolver", "LearningResource"]andlearningResourceType: "Math Solver". - Missing usageInfo: Google lists the privacy policy URL as required.
- Markup on an inner page only: Google asks for it on the home page.
Required properties
@type = [MathSolver, LearningResource]urlusageInfolearningResourceType = Math SolverpotentialAction.@type = SolveMathActionpotentialAction.targetpotentialAction.mathExpression-input
Recommended properties
inLanguageassessespotentialAction.eduQuestionType
{
"@context": "https://schema.org",
"@type": [
"MathSolver",
"LearningResource"
],
"name": "Example Math Solver",
"url": "https://www.example.com/",
"usageInfo": "https://www.example.com/privacy",
"inLanguage": "en",
"learningResourceType": "Math Solver",
"potentialAction": [
{
"@type": "SolveMathAction",
"target": "https://www.example.com/solve?q={math_expression_string}",
"mathExpression-input": "required name=math_expression_string",
"eduQuestionType": [
"Polynomial Equation",
"Derivative"
]
}
]
}FAQs
What does MathSolver structured data do?ShowHide
It tells Google how to send a math expression to your solver: a SolveMathAction whose target URL template contains a placeholder that Google fills with the expression.
How do I define the action target?ShowHide
Use a URL template with a placeholder, such as https://example.com/solve?q={math_expression_string}, and set mathExpression-input to required name=math_expression_string. The name must match the placeholder.
Where does the markup go?ShowHide
Google's guidelines say to add MathSolver structured data to the home page of your site.
Can the solver be behind a login?ShowHide
Not entirely. Google doesn't allow math solvers that are fully behind a login or paywall: the solution and step-by-step walkthrough for the user's first problem must be accessible.