How do I set up a dynamic FAQ (Q-SEO) page on my website?

This feature need to be activated by your account manager

There are two possibilities to insert snippets into your site:

Method #1: possibility is to put them on the homepage of your site (recommended).
Method #2: create a specific page.

‼️To increase your chances of being featured in Google’s snippets and AI-generated search results, we recommend creating a dedicated FAQ page. For maximum effectiveness, name it 'Official FAQ of [Hotel Name]' and ensure this title appears in both the page URL and meta description to enhance indexing by search engines and AI platforms alike.

Example:

https://www.hotel-bassano.com/

Method #1: Respecting the look and feel of your site

Step 1 > Creating the FAQ

For this method, there are two separate important steps 2 and 3 to successfully implement your Snippets and FAQ page:

Step 2 > Render FAQ inside the page

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, here is the API GET endpoint:

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."

}} ]

The Webmaster needs to implement the code which calls the previously defined request, parse its content and display the Q&A on the hotel's website.

Step 3 > FAQ Structured Data Integration

After you display the data on the FAQ page from step A, make sure to add the Snippets script onto the FAQ page HTML according to the page’s language.

This is crucial to be eligible to have a rich result on the Search Engine Results Page.

Below is the format of the Snippets script to add:

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

Installing the Q-SEO Script alone is not enough to display the FAQ

Many webmasters assume that simply installing the Q-SEO script (like the one provided by Quicktext) is sufficient to make the FAQ content visible on the website. However, this is not the case.

✅ What else is required?

In addition to adding the script tag:

You must implement:

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.
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 (for PHP)

Here’s a basic example (see screenshot) written in PHP:

php

CopyEdit

<?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 } ?>

Note: This is just an example in PHP. You will need to write equivalent logic in the programming language or CMS (e.g., WordPress, React, Python, etc.) that your website is built on.

🔄 Why this extra step?

The script only loads the structured FAQ data in the background (for SEO purposes like Google Rich Results). It does not render anything visually by default. That’s why this additional implementation is required to actually display the FAQ content to your users.

Hybrid FAQ (can be implemented on any page of the website)

If you wish to select the topics (Q/A) you wish to display on a particular page please add the parameter "data-q-data" to the script with the number of Quicktext dialog that you wish to display as Q&A on the FAQ page.

Example:

You want to display only F&B FAQ on the restaurant page==> data-q-data= 18-01, 18-05, 18-07, 18-08, 18-11

You can find the names of dialogs with their numbers here

The Webmaster must insert this Script inside the FAQ's HTML page.
Replace XXXXX-XXXX with the provided license (Tobe provided by your account manager at Quicktext) and XX with the preferred language: en, fr, es, pt, de, or it (make sure the languages are activated in your Quicktext plan).

Example of an FAQ-rich result on Google search result page:

💡Idea: 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.

Step 4 > Validate your page

Validate your page using the Rich Results Test to test that your page is eligible for showing as a rich result.

Here are some examples of what you'll see when using the tool and you have well implemented the structured data :

Method #2: create a quick dedicated FAQ page (not with respect with your site look and feel)

Quicktext provides an easy way to generate the snippets. It’s a kind of do-it-yourself with a minimum of code but might not match exactly your website’s theme.

Step 1 > Follow the instructions on: https://qt.im/faqdombuilder

Set the provided license ID and submit, it will show you a preview and the script ready to be inserted in your FAQ page.

Hybrid FAQ (can be implemented on any page of the website)

You can select the topic (Q/A) you wish to display on a particular page of your website by selecting the number of dialogs intended for the display of the FAQ Dom builder

Example:

You want to display only F&B FAQ on the restaurant page==> data-q-data= 18-01, 18-05, 18-07, 18-08, 18-11

You can find the names of dialogs with their numbers here

You can set the background color, the border-radius and the transition duration to match your website’s theme.

The Webmaster must insert the provided Script inside the FAQ's HTML page (before the body closing tag). And the script will render the FAQ inside the tag referenced by the CSS selector provided in the “data-render-in” attribute’s value.

Example of integration: Marignan Champs Elysees - Luxury hotel in Paris - FAQ

Step 2 > Validate your page

Validate your page using the Rich Results Test to test that your page is eligible for showing as a rich result.

Here are some examples of what you'll see when using the tool and you have well implemented the structured data :

Optimisation of dedicated specific FAQ page

Step 1 > SEO and AEO Optimisation

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

Add Meta description:
Example: Visit the official FAQ of [Hotel Name] to get clear, reliable answers to the most common questions about reservations, check-in, services, and more. Plan your stay with confidence.
Url:
Example: www.[hotelname].com/official-faq

‼️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

Step 2 > Create a strong link on your home page

Example -> https://www.hotel-belle-juliette-paris.com/

You should include the FAQs page in the main menu or in the footer of the site.

Example: At the bottom of the page :

English: Official FAQ to all your questions
Spanish : FAQ oficiales a todas tus preguntas
French : FAQ officielles à toutes vos questions

Step 3 > Add the FAQ page on your website menu

Example of FAQ page

If you need any assistance contact your account manager