AI: how to add schema code to your single-page website
Schema code is information within your website that AI can access but isn’t visible.
Your Flat White website contains schema information for the overall structure and purpose of your website.
To add your individual content, you need to generate SON-LD schema code.
Don’t worry – it’s easier than it sounds, and Fred will help you too.
This blog is for our single-page websites – The Espresso. If you have a multi-page Macchiato, Cappuccino or Flat White website, I’ve written a separate blog to talk you through what you need to do.
How to generate schema code for your single-page website
Step 1: add details of your business
You need to provide information that follows the right language for schema.
Copy the content between the lines, and paste into an editing tool (I did it in Notes on my mac). Replace the red text in square brackets with your own content. If you don’t have information to add (e.g. professional qualifications, team member), delete that line.
Business details
Business name: [insert name]
Website URL: [insert URL]
Location: [city, region, country]
Service area: [country or region served, if applicable]
Business type: [example: Organization, LocalBusiness, Person]
About the business
[Insert a short description of what the business does]
Founder/Team details (if applicable)
Founders:
– [Name 1], [Job Title 1]
– [Name 2], [Job Title 2]
Team members (if applicable):
– [Name 1], [Job Title 1], [Short description of role]
Contact details
– Telephone: [insert phone number, if applicable]
– Email: [insert email address]
– Address: [insert full address, if applicable]
– Contact type: [e.g. Customer Service, Sales, Support]
Profiles to include in sameAs
[List profile URLs such as LinkedIn, Instagram, directories, Google profile]
Core services
[List the services you want recognised, if applicable]
Expertise topics
[List topics the business should be associated with, if applicable]
Step 2: generate the schema code
Paste the following block of text between the lines into your chosen AI tool (we use Le Chat, which is a more ethical alternative to ChatGPT or Claude):
Write valid JSON-LD schema for my single page website.
Follow these rules.
- Format into a code block
- Use schema.org vocabulary
- Output only the code inside a script tag
- Use JSON-LD format
- Do not include explanations
- Use a clear entity structure with @graph when appropriate
- Avoid adding fields that are not supported by schema.org
Then paste in the block of content from your editing tool, including all the information you’ve added.
Step 3: validate the schema code
Copy the complete answer from your AI tool, and paste into this code validator – click button below:
Select ‘Run new test’ and choose ‘Code snippet’ and simply paste your code.
- If no errors, your schema code is ready. Save it!
- If an error appears: copy the error message, paste it back into your AI tool, and ask it to fix the code. Then validate the corrected version again. When it’s ready, save it!
Save the code when it works, ready for step 4…
Step 4: book a call with Fred
When you’ve generated and saved your schema code, book a chat with Fred. He’ll then add the code in the right place on your website.
Well done! Your website now contains optimised schema for AI to use.
Extra reference guide for ‘Business Type’
When creating schema code, you’ll need to choose your business type. This tells search engines and AI tools what type of business your website represents. Choosing the correct type helps these systems categorise your business and understand how your goods or services should appear in search results.
Use the guide below to select the option that best matches your business.
Person
- Best for: solo personal brands, coaches, consultants, creators, or speakers.
- Signals: describes a real person as the expert or brand behind the website. Use when the founder’s name is the brand (e.g., “Jane Doe Designs”).
- Example: freelancers, influencers, or solo practitioners.
Organization
- Best for: companies, agencies, studios, or brands where the business name is the main identity.
- Signals: describes a company or brand (not an individual). Use for businesses with teams or a brand name separate from a person’s name.
- Example: “Flat White Websites,” “Acme Corp.”
LocalBusiness
- Best for: businesses with a physical location or serving a specific geographic area (e.g., restaurants, salons, gyms, dentists).
- Signals: connects the business to a physical location, improving local SEO.
- Note: LocalBusiness is a subtype of Organisation, so it inherits all Organisation properties.
Category: Demystifying Websites, Uncategorised