Skip to content
  • There are no suggestions because the search field is empty.

How to set up a Q-SEO?

Q-SEO is a feature that lets you automatically generate a FAQ page on your website, based on the questions and answers collected from Velma. This helps your site show relevant FAQ content to visitors and increases your chances of being surfaced in search engine results or AI-powered search summaries.

  1. Introduction

  2. Dynamic FAQ
     2.1. Where to install the dynamic FAQ
     2.2. How to optimize the FAQ page for SEO and AEO
     2.3. How to install Q-SEO using the quick method
     2.4. How to install Q-SEO to match your website’s look and feel

  3. Static FAQ
     3.1. Where to install the static FAQ
     3.2. How to install the static FAQ

  4. Verification
     4.1. How to check that your FAQ is properly installed



1. Introduction

Q-SEO is a feature that automatically generates FAQ content from Q-Data through an installable script. Two formats are available.

  • The dynamic FAQ updates every week based on the questions asked to Velma.

  • The static FAQ allows you to display fixed, topic-based questions and answers.

This article explains how to install both formats, how to optimize your FAQ pages for SEO and AEO, and how to verify that your implementation is correct.

2. Dynamic FAQ

2.1. Where to install the dynamic FAQ

You can install the dynamic FAQ script in two ways:

  • On a dedicated FAQ page (recommended).

  • At the bottom of the homepage.

A dedicated page offers better performance for search engines and a clearer user journey.

 

2.2. How to optimize the FAQ page for SEO and AEO

To improve visibility in both Google results and AI-generated answers, you should create a dedicated page titled “Official FAQ of [Hotel Name]”. This title should appear in:

  • the page URL

  • the meta title

  • the meta description

Recommended meta elements:

  • Meta title: Official FAQ | [Hotel Name] | Your Questions Answered

  • Meta description: Visit the official FAQ of [Hotel Name] to find clear and reliable answers to the most common questions about reservations, check-in, services, and more.

  • Suggested URL: www.[hotelname].com/official-faq

To ensure optimal internal visibility, link the FAQ page from:

  • the main navigation menu

  • the website footer

  • a highlighted section of the homepage

Examples of FAQ implementations :

2.3. How to install Q-SEO using the quick method


The quick installation method provides an immediately usable script with minimal technical setup. It may not perfectly match your website design but is ideal for fast deployment.

Steps to follow:

  1. Go to https://qt.im/faqdombuilder
  2. Enter your license ID.
  3. Select a language (en, fr, es, pt, de, or it).
  4. Click “Submit” to display a preview and generate the script.
  5. Copy the script and paste it inside the <body> tag of your website.

    2.4. How to install Q-SEO to match your website’s look and feel

    Use the method that best fits your website structure and design to create and display the FAQ page. The script’s visual style (CSS) can be easily adapted by your webmaster to match your site’s look and feel for seamless integration.

    Quicktext provides an API with a JSON formatted Q&A, allowing the Webmaster to render the Q&A inside the FAQ page of the Hotel's website 

    The API endpoint is:

    https://snippets.quicktext.im/v2/get/snippets?license=XXXXX-XXXX&lang=XX&top=20

     

    Replace XXXXX-XXXX with the provided license ID and XX with the preferred language: en, fr, es, pt, de, or it (make sure the languages are activated in your Quicktext plan).

    Quicktext JSON response example:

    [ {

        "@type": "Question",

        "name": "What are the opening/closing dates at the Hotel ?",

        "acceptedAnswer": {

            "@type": "Answer",

            "text": "We have adapted … using the code XXXXX.<br/>"

        }

    }, {

        "@type": "Question",

        "name": "What is the price of breakfast at the Hotel ?",

        "acceptedAnswer": {

            "@type": "Answer",

            "text": "Breakfast is included … depends on your choice."

        }} ]

    Your webmaster must:

    • Call the API,

    • Parse the JSON data,

    • Display the questions and answers using your HTML structure,

    • Apply CSS for seamless integration.

    Once the FAQ content is displayed, the structured data script must be added so search engines can detect it.

    Structured data script:

    <script
      src="https://snippets.quicktext.im/static/snippets.min.js"
      data-license="XXXXXXXXX"
      data-lang="XX"
      data-top="20"
    ></script>

    Because Q-SEO FAQs are primarily optimized for SEO and AEO, they aren’t automatically visible to your visitors. To display them on your website, you need to follow the next steps.

    You must implement:

    1. A "For Loop"
      This loop retrieves and displays the individual FAQ items (question and answer) from the JSON data returned by the script's backend.
    2. CSS Structure (Cascade)
      You'll need to define a proper HTML structure and accompanying CSS classes (or use your site’s styles) to visually format the questions and answers as an accordion or a readable list.
    Example of rendering with PHP:
    <?php
    $faqs = json_decode(file_get_contents('https://snippets.quicktext.im/v2/get/snippets?license=YOUR_LICENSE_KEY&lang=en'));
    for ($i = 0; $i < count($faqs); $i++) {
    ?>
    <div class="accordion-item">
      <h2><?php echo $faqs[$i]->name ?></h2>
      <div><?php echo $faqs[$i]->acceptedAnswer->text ?></div>
    </div>
    <?php } ?>

    💡Tips: For individual hotel pages, it is recommended to include a specific FAQs section with an anchor in the submenu. This will facilitate navigation, especially if the section is at the bottom of the page.

     

     

    3. Static FAQ

    3.1. Where to install the static FAQ

    Static FAQs are best suited for pages dedicated to specific topics. For example, you may display SPA-related questions on your wellness page.  Static FAQs allow you to show only the information relevant to the selected theme.

     

    3.2. How to install the static FAQ

    To install a static FAQ:

    1. Go to https://snippets.quicktext.im/static/faq_dom_builder.html

    2. Enter your license ID

    3. Select the dialog to display.

    4. Choose the language.

    5. Click “Submit” to generate the script.

    6. Insert the script before the closing </body> tag of the target page.

    7. The script will automatically render the FAQ using the element defined in the data-render-in attribute.

     

    4. Verification

    4.1. How to check that your FAQ is properly installed

    To verify that your structured data is valid and that your page is eligible for rich results, use Google’s Rich Results Test: https://search.google.com/test/rich-results

     

     

     

    💡Tips: You should implement "IndexNow" (to speed up the appearance of your content in AI-generated results) and the LLMS.txt file

    LLMS.txt is a technical file similar to robots.txt that allows you to indicate the pages or content you want Large Language Models (LLMs), such as ChatGPT, Claude, Perplexity and Google, to use. This is important because it allows you to control how the AI models and response engines access, use or index the content