Skip to content
Lonely Planet Docs

Rich Text → Content Blocks

Overview

Section titled “Overview”

Goal: Convert a Contentful Rich Text + linked entries payload into a consumer-friendly object that offers both:

  1. Structured contentBlocks (EditorJS-like format which exists in CAPI today)
  2. Single concatenated contentHtml string (for RSS, email, SEO previews, etc.)

This document explains the mapping rules, transformation logic, and edge cases for converting Contentful Rich Text into structured content blocks. As the transformer evolves, this guide will be updated to reflect new features and improvements. Inside, you’ll find a thorough walkthrough of how the Contentful Rich Text GraphQL API is processed by the Customs Transformer and delivered to Rakirura and Kakado. You’ll also see examples illustrating how Rakirura will ultimately replace CAPI on the frontend.

Critical Compatibility Note

Section titled “Critical Compatibility Note”

The contentBlocks output format is essential for maintaining compatibility with the existing Content API (CAPI) that powers the live website. The current production system relies on this structured format for rendering articles across multiple platforms and contexts.

TL;DR

Section titled “TL;DR”
  • Convert paragraph and heading nodes to blocks with two content fields: contentHtml (complete HTML with tags) and innerHtml (inner HTML without wrapper tags)
  • Tips include two fields: contentHtml and innerHtml for consistency
  • Resolve embedded entries/resources to concrete block types (canto_image, quote, snipped, journeys_destination, etc.)
  • Build a full contentHtml string for the entire article or narrative by concatenating the per-block HTML fragments in order

Input Schema

Section titled “Input Schema”

Contentful GraphQL Query Example

Section titled “Contentful GraphQL Query Example”
query GetRichContentItem {
  richContent(id: "5kUKsBH2mRyRZL2R72MTly") {
    title
    sidebar
    sponsorship {
      title
      externalUrl
    }
    body {
      json
      links {
        entries {
          block {
            __typename
            sys {
              id
            }
            ... on ImageAsset {
              imageUrl
              imageCaption
              imageDescription
            }
            ... on JourneysDestination {
              title
              url
              requestUrl
              image {
                ... on ImageAsset {
                  ...ImageAsset
                }
              }
            }
            ... on Tip {
              title
              body {
                json
              }
            }
            ... on Quote {
              content
              author
            }
          }
        }
      }
    }
  }
}

Input Notes

Section titled “Input Notes”
  • body.json contains Contentful Rich Text format
  • body.links.entries.block resolves referenced entries by sys.id or URN (for embedded-resource-block)

Output Schema

Section titled “Output Schema”

Top-Level Structure

Section titled “Top-Level Structure”
{
  "richContent": {
    "title": "Italy",
    "sidebar": true,
    "sponsorship": null,
    "contentBlocks": [
      {
        "type": "canto_image",
        "id": "img-5usCfn0kmgWygbtZl9wL3C",
        "data": {
          "src": "https://d2vbr83hnyiux1.cloudfront.net/image/975050285728/image_kve2ssv0st38vab2g03cjrjc3g",
          "alt": "Vatican, Rome, Italy-Sept. 07, 2018.  View of square of St. Peter and basilica of St. Peter in Vatican at sunny day, Rome, Italy, License Type: media, Download Time: 2025-02-18T21:18:57.000Z, User: katelyn.perry_lonelyplanet, Editorial: true, purchase_order: 65050 - Digital Destinations and Articles, job: WiP, client: WiP, other: Katelyn Perry",
          "caption": "St. Peter's Basilica, Vatican City. leonori/Shutterstock",
          "title": "5usCfn0kmgWygbtZl9wL3C"
        }
      },
      {
        "type": "header",
        "id": "hdr-a1",
        "data": {
          "level": 2,
          "contentHtml": "<h2>Culture, cuisine and coastlines</h2>",
          "innerHtml": "Culture, cuisine and coastlines"
        }
      },
      {
        "type": "paragraph",
        "id": "p-a2",
        "data": {
          "contentHtml": "<p>Most summer destinations either lean into big, flashy experiences or quiet moments and simple pleasures. Italy says, ‘Why choose?’ Long, sunny days are perfect for gazing at awe-inspiring ancient relics and architectural bombast, wandering through a rolling Chianti vineyard or sitting on a pastel balcony with an aperitivo or gelato in hand. And if you’re ready for a break from the Mediterranean sun, few places offer such achingly beautiful places indoors, between buildings and on the water. From romantic Venice to spectacular Sicily, with plenty of pasta in between, a summer trip to Italy will tick all your boxes.</p>",
          "innerHtml": "Most summer destinations either lean into big, flashy experiences or quiet moments and simple pleasures. Italy says, ‘Why choose?’ Long, sunny days are perfect for gazing at awe-inspiring ancient relics and architectural bombast, wandering through a rolling Chianti vineyard or sitting on a pastel balcony with an aperitivo or gelato in hand. And if you’re ready for a break from the Mediterranean sun, few places offer such achingly beautiful places indoors, between buildings and on the water. From romantic Venice to spectacular Sicily, with plenty of pasta in between, a summer trip to Italy will tick all your boxes."
        }
      },
      {
        "type": "quote",
        "id": "q-55E86HxPnBYq6dRwQhsy0M",
        "data": {
          "text": "This is the ideal time to eat and drink by the sea, beneath a mountain or in a piazza; to drive, hike or cycle through impossibly pretty hills; or take your passeggiata through city streets packed with art, history and people-watching. Italy in summer is simply enchanting.",
          "caption": "— Daniel Bolger, Italy Destination Editor"
        }
      },
      {
        "type": "canto_image",
        "id": "img-1bibB45b6U7ABlGEpXggwG",
        "data": {
          "src": "https://d2vbr83hnyiux1.cloudfront.net/image/975050285728/image_mgjn61r9ah3pj5c5l6lu2saj43",
          "alt": "August 2024: Sassi Beach in Orta San Giulio, Piedmont, Italy. Claudia Gori for Lonely Planet",
          "caption": "Sassi Beach in Orta San Giulio. Claudia Gori for Lonely Planet",
          "title": "1bibB45b6U7ABlGEpXggwG"
        }
      },
      {
        "type": "header",
        "id": "hdr-a3",
        "data": {
          "level": 2,
          "contentHtml": "<h2>Peaks and valleys</h2>",
          "innerHtml": "Peaks and valleys"
        }
      },
      {
        "type": "paragraph",
        "id": "p-a4",
        "data": {
          "contentHtml": "<p>With rugged alpine mountains and fuming southern volcanoes, Italy’s landscape is a magnificent outdoor playground. Twenty-five national parks span terrain from sky-high rock spires in the Dolomites to the silent slopes of Le Marche. If you’re lucky, you might catch sight of a chamois, ibex, golden eagle, peregrine falcon or even a Marsican brown bear. If a spot by the water is more your speed, Italy has four seas and a coastline that stretches for 7600km (4700 miles). Whether you’re after an idyllic cove framed by plunging cliffs or a sandy strip lapped by azure waters, you’ll find somewhere to suit your style.</p>",
          "innerHtml": "With rugged alpine mountains and fuming southern volcanoes, Italy’s landscape is a magnificent outdoor playground. Twenty-five national parks span terrain from sky-high rock spires in the Dolomites to the silent slopes of Le Marche. If you’re lucky, you might catch sight of a chamois, ibex, golden eagle, peregrine falcon or even a Marsican brown bear. If a spot by the water is more your speed, Italy has four seas and a coastline that stretches for 7600km (4700 miles). Whether you’re after an idyllic cove framed by plunging cliffs or a sandy strip lapped by azure waters, you’ll find somewhere to suit your style."
        }
      },
      {
        "type": "tip",
        "id": "tip-2vcVHc5wkYXMoBBm10vpsr",
        "data": {
          "title": "Editor tip: plan alpine-to-sea days",
          "contentHtml": "<p>Start early in the Dolomites for cooler hikes, then retreat to a lakeside town by afternoon. Book refugios ahead in peak season and carry cash for lift stations.</p>",
          "innerHtml": "Start early in the Dolomites for cooler hikes, then retreat to a lakeside town by afternoon. Book refugios ahead in peak season and carry cash for lift stations."
        }
      },
      {
        "type": "canto_image",
        "id": "img-42i7pMxuVTRqTArGlcVdSx",
        "data": {
          "src": "https://d2vbr83hnyiux1.cloudfront.net/image/975050285728/image_qf3q25mm7p4619p8kos5j3u21i",
          "alt": "August 2024: Pane e Vino - Enogastronomia is a cozy Orta San Giulio restaurant that offers a wide selection of local cheeses, charcuterie, and wines. Claudia Gori for Lonely Planet",
          "caption": "Local cheeses, charcuterie, and wines. Claudia Gori for Lonely Planet",
          "title": "42i7pMxuVTRqTArGlcVdSx"
        }
      },
      {
        "type": "header",
        "id": "hdr-a5",
        "data": {
          "level": 2,
          "contentHtml": "<h2>Wonders of the Table</h2>",
          "innerHtml": "Wonders of the Table"
        }
      },
      {
        "type": "paragraph",
        "id": "p-a6",
        "data": {
          "contentHtml": "<p>Italy is a country that lives to eat, where food is central to social life and culinary traditions are revered with heartfelt pride. Dishes are prepared with seasonal ingredients, and historic piazzas and seafront promenades provide a ready supply of memorable settings. In summer, Italian markets swell with mounds of fresh produce: plump eggplants, vivid red peppers, peaches, figs, watermelons and ripe lemons from the Amalfi Coast. For seafood lovers, this is a good time for <em>cozze</em> (mussels).</p>",
          "innerHtml": "Italy is a country that lives to eat, where food is central to social life and culinary traditions are revered with heartfelt pride. Dishes are prepared with seasonal ingredients, and historic piazzas and seafront promenades provide a ready supply of memorable settings. In summer, Italian markets swell with mounds of fresh produce: plump eggplants, vivid red peppers, peaches, figs, watermelons and ripe lemons from the Amalfi Coast. For seafood lovers, this is a good time for <em>cozze</em> (mussels)."
        }
      },
      {
        "type": "canto_image",
        "id": "img-4Ag9rD5SltMHQLNxnVLgs5",
        "data": {
          "src": "https://d2vbr83hnyiux1.cloudfront.net/image/975050285728/image_r1v563gfch2i5bj6bmkaq5n421",
          "alt": "ROME - JULY 21 : Italian actors play a comedy titled Nerone (Nero Roman emperor) at the Massenzio Basilica (a part of the Roman Forum near the Colosseum) during The Estate Romana (Roman Summer) , on July 21, 2007 in  Rome, Italy. The city, at least in the summer, bursts into an orgy of culture -- music, theatre, opera, jazz, late night eating and strolling, book fairs and the like. (Photo by Franco S. Origlia/Getty Images)\n82033389\n",
          "caption": "Massenzio Basilica in Rome, during The Estate Romana. Franco S. Origlia/Getty Images",
          "title": "4Ag9rD5SltMHQLNxnVLgs5"
        }
      },
      {
        "type": "header",
        "id": "hdr-a7",
        "data": {
          "level": 2,
          "contentHtml": "<h2>Essential events</h2>",
          "innerHtml": "Essential events"
        }
      },
      {
        "type": "list",
        "id": "list-a1",
        "data": {
          "style": "unordered",
          "items": [
            "<strong>Estate Romana:</strong> Rome puts on a summer calendar of events that turn the city into an outdoor stage. Music, dance, literature and film events are staged at some of the city’s most evocative venues. <em>June–October</em>",
            "<strong>Palio:</strong> Siena’s Piazza del Campo sets the stage for this daredevil horse race. Centuries-old rituals surround the event, where costumed riders represent each of the city’s medieval <em>contrade</em> (districts). <em>July–August</em>",
            "<strong>Venice Film Festival:</strong> One of the world’s most prestigious cinematic events, this festival is held at the Lido and draws the international film glitterati with its red-carpet premieres and paparazzi glamor. <em>August–September</em>"
          ]
        }
      },
      {
        "type": "journeys_destination",
        "id": "trip-3AdKslYmeItHMz9atFc4Iq",
        "data": {
          "title": "Italy",
          "url": "https://www.elsewhere.io/italy",
          "requestUrl": "https://request.elsewhere.io/?destination=italy",
          "image": {
            "imageUrl": "https://lp-cms-production.imgix.net/public/2023-08/ITALY_example.jpg",
            "imageCaption": "Beautiful Italian landscape"
          }
        }
      },
      {
        "type": "header",
        "id": "hdr-a8",
        "data": {
          "level": 2,
          "contentHtml": "<h2>Make it happen</h2>",
          "innerHtml": "Make it happen"
        }
      },
      {
        "type": "paragraph",
        "id": "p-a7",
        "data": {
          "contentHtml": "<p>You could spend a lifetime of summers in Italy and never see half the things it has to offer. But in a week to 10 days, you can...</p>",
          "innerHtml": "You could spend a lifetime of summers in Italy and never see half the things it has to offer. But in a week to 10 days, you can..."
        }
      },
      {
        "type": "list",
        "id": "list-a2",
        "data": {
          "style": "unordered",
          "items": [
            "<strong>Hit the highlights (10 days):</strong> Glide through the haunting canals of Venice, eat your fill in Bologna, revel in the Renaissance masterpieces of Florence, wander through the greatest hits of Rome, and live it up in Naples.",
            "<strong>Focus on the North (10 days):</strong> Start in style in Milan, then cut over to the <em>palazzi</em> (and balconies) of <a href=\"https://www.lonelyplanet.com/destinations/italy/lombardy-and-the-lakes/mantua\">Mantua</a> and Verona. Marvel at architectural wonders in Vicenza and Padua before hiking natural ones in the Dolomites.",
            "<strong>See the South Coast (7 days):</strong> Explore Naples and the ruins of Pompeii, then soak up the sun in Sorrento and catch a boat for Capri. Cap it off with Instagrammable Positano and the busy Amalfi Coast.",
            "<strong>Get a slice of Sicily (7 days):</strong> From the black lava streets of Catania to the ancient Greek temples of Agrigento, honey-hued towns set amid citrus and olive groves showcase the island’s spectacular baroque beauty."
          ]
        }
      },
      {
        "type": "tip",
        "id": "tip-46t8YgzlpBoexSUquiVooP",
        "data": {
          "title": "Editor tip: booking high season",
          "contentHtml": "<p>Reserve coastal stays and intercity trains well in advance from mid-June to early September. Flexible travelers should look at shoulder weeks for better prices.</p>",
          "innerHtml": "Reserve coastal stays and intercity trains well in advance from mid-June to early September. Flexible travelers should look at shoulder weeks for better prices."
        }
      }
    ],
    "contentHtml": "<figure><img src=\"https://d2vbr83hnyiux1.cloudfront.net/image/975050285728/image_kve2ssv0st38vab2g03cjrjc3g\" alt=\"Vatican, Rome, Italy-Sept. 07, 2018.  View of square of St. Peter and basilica of St. Peter in Vatican at sunny day, Rome, Italy, License Type: media, Download Time: 2025-02-18T21:18:57.000Z, User: katelyn.perry_lonelyplanet, Editorial: true, purchase_order: 65050 - Digital Destinations and Articles, job: WiP, client: WiP, other: Katelyn Perry\" data-title=\"5usCfn0kmgWygbtZl9wL3C\"/><caption>St. Peter's Basilica, Vatican City. leonori/Shutterstock</caption></figure><h2>Culture, cuisine and coastlines</h2><p>Most summer destinations either lean into big, flashy experiences or quiet moments and simple pleasures. Italy says, ‘Why choose?’ Long, sunny days are perfect for gazing at awe-inspiring ancient relics and architectural bombast, wandering through a rolling Chianti vineyard or sitting on a pastel balcony with an aperitivo or gelato in hand. And if you’re ready for a break from the Mediterranean sun, few places offer such achingly beautiful places indoors, between buildings and on the water. From romantic Venice to spectacular Sicily, with plenty of pasta in between, a summer trip to Italy will tick all your boxes.</p><blockquote>This is the ideal time to eat and drink by the sea, beneath a mountain or in a piazza; to drive, hike or cycle through impossibly pretty hills; or take your passeggiata through city streets packed with art, history and people-watching. Italy in summer is simply enchanting.<footer>— Daniel Bolger, Italy Destination Editor</footer></blockquote><figure><img src=\"https://d2vbr83hnyiux1.cloudfront.net/image/975050285728/image_mgjn61r9ah3pj5c5l6lu2saj43\" alt=\"August 2024: Sassi Beach in Orta San Giulio, Piedmont, Italy. Claudia Gori for Lonely Planet\" data-title=\"1bibB45b6U7ABlGEpXggwG\"/><caption>Sassi Beach in Orta San Giulio. Claudia Gori for Lonely Planet</caption></figure><h2>Peaks and valleys</h2><p>With rugged alpine mountains and fuming southern volcanoes, Italy’s landscape is a magnificent outdoor playground. Twenty-five national parks span terrain from sky-high rock spires in the Dolomites to the silent slopes of Le Marche. If you’re lucky, you might catch sight of a chamois, ibex, golden eagle, peregrine falcon or even a Marsican brown bear. If a spot by the water is more your speed, Italy has four seas and a coastline that stretches for 7600km (4700 miles). Whether you’re after an idyllic cove framed by plunging cliffs or a sandy strip lapped by azure waters, you’ll find somewhere to suit your style.</p><aside data-type=\"tip\"><h4>Editor tip: plan alpine-to-sea days</h4><p>Start early in the Dolomites for cooler hikes, then retreat to a lakeside town by afternoon. Book refugios ahead in peak season and carry cash for lift stations.</p></aside><figure><img src=\"https://d2vbr83hnyiux1.cloudfront.net/image/975050285728/image_qf3q25mm7p4619p8kos5j3u21i\" alt=\"August 2024: Pane e Vino - Enogastronomia is a cozy Orta San Giulio restaurant that offers a wide selection of local cheeses, charcuterie, and wines. Claudia Gori for Lonely Planet\" data-title=\"42i7pMxuVTRqTArGlcVdSx\"/><caption>Local cheeses, charcuterie, and wines. Claudia Gori for Lonely Planet</caption></figure><h2>Wonders of the Table</h2><p>Italy is a country that lives to eat, where food is central to social life and culinary traditions are revered with heartfelt pride. Dishes are prepared with seasonal ingredients, and historic piazzas and seafront promenades provide a ready supply of memorable settings. In summer, Italian markets swell with mounds of fresh produce: plump eggplants, vivid red peppers, peaches, figs, watermelons and ripe lemons from the Amalfi Coast. For seafood lovers, this is a good time for <em>cozze</em> (mussels).</p><figure><img src=\"https://d2vbr83hnyiux1.cloudfront.net/image/975050285728/image_r1v563gfch2i5bj6bmkaq5n421\" alt=\"ROME - JULY 21 : Italian actors play a comedy titled Nerone (Nero Roman emperor) at the Massenzio Basilica (a part of the Roman Forum near the Colosseum) during The Estate Romana (Roman Summer) , on July 21, 2007 in  Rome, Italy. The city, at least in the summer, bursts into an orgy of culture -- music, theatre, opera, jazz, late night eating and strolling, book fairs and the like. (Photo by Franco S. Origlia/Getty Images)\n82033389\n\" data-title=\"4Ag9rD5SltMHQLNxnVLgs5\"/><caption>Massenzio Basilica in Rome, during The Estate Romana. Franco S. Origlia/Getty Images</caption></figure><h2>Essential events</h2><ul><li><strong>Estate Romana:</strong> Rome puts on a summer calendar of events that turn the city into an outdoor stage. Music, dance, literature and film events are staged at some of the city’s most evocative venues. <em>June–October</em></li><li><strong>Palio:</strong> Siena’s Piazza del Campo sets the stage for this daredevil horse race. Centuries-old rituals surround the event, where costumed riders represent each of the city’s medieval <em>contrade</em> (districts). <em>July–August</em></li><li><strong>Venice Film Festival:</strong> One of the world’s most prestigious cinematic events, this festival is held at the Lido and draws the international film glitterati with its red-carpet premieres and paparazzi glamor. <em>August–September</em></li></ul><p><a href=\"https://www.elsewhere.io/italy\">Plan a custom trip to Italy with Elsewhere</a></p><h2>Make it happen</h2><p>You could spend a lifetime of summers in Italy and never see half the things it has to offer. But in a week to 10 days, you can...</p><ul><li><strong>Hit the highlights (10 days):</strong> Glide through the haunting canals of Venice, eat your fill in Bologna, revel in the Renaissance masterpieces of Florence, wander through the greatest hits of Rome, and live it up in Naples.</li><li><strong>Focus on the North (10 days):</strong> Start in style in Milan, then cut over to the <em>palazzi</em> (and balconies) of <a href=\"https://www.lonelyplanet.com/destinations/italy/lombardy-and-the-lakes/mantua\">Mantua</a> and Verona. Marvel at architectural wonders in Vicenza and Padua before hiking natural ones in the Dolomites.</li><li><strong>See the South Coast (7 days):</strong> Explore Naples and the ruins of Pompeii, then soak up the sun in Sorrento and catch a boat for Capri. Cap it off with Instagrammable Positano and the busy Amalfi Coast.</li><li><strong>Get a slice of Sicily (7 days):</strong> From the black lava streets of Catania to the ancient Greek temples of Agrigento, honey-hued towns set amid citrus and olive groves showcase the island’s spectacular baroque beauty.</li></ul><aside data-type=\"tip\"><h4>Editor tip: booking high season</h4><p>Reserve coastal stays and intercity trains well in advance from mid-June to early September. Flexible travelers should look at shoulder weeks for better prices.</p></aside>"
  }
}

Current CAPI Implementation Reference

Section titled “Current CAPI Implementation Reference”

Live Website Example

Section titled “Live Website Example”

The following payload structure is currently live on the website and demonstrates why maintaining the contentBlocks format is critical. This example shows the actual output format that the production Content API delivers:

{
  "data": {
    "article": {
      "contentBlocks": [
        {
          "data": {
            "text": "Green <a href=\"https://www.lonelyplanet.com/spain\">Spain</a>'s wild coastline, gastronomic delights, charming historic towns and unique cultural identity are incomparable. Nature and tradition have blessed these four provinces (Galicia, <a href=\"https://www.lonelyplanet.com/spain/asturias\">Asturias</a>, <a href=\"https://www.lonelyplanet.com/spain/cantabria\">Cantabria</a> and <a href=\"https://www.lonelyplanet.com/spain/basque-country\">Basque Country</a>) with something for everyone, from hardcore adventurers to laid-back beachgoers."
          },
          "id": "f12a1609-f6c6-4d68-9f43-0cb7796c98fe",
          "type": "paragraph"
        },
        {
          "data": {
            "text": "In fact, there’s so much this northern region of Spain offers – for so many different types of travelers – that the best way to start planning is to talk to a local, passionate and expert guide."
          },
          "id": "9a9bac94-1cac-4ea0-b74b-a321ccf9f469",
          "type": "paragraph"
        },
        {
          "data": {
            "text": "We spoke with Estefanía Gonzalez, an Official Tourist Guide of Galicia and a cultural mediator at Parque Arqueolóxico da Cultura Castrexa, an archaeological park and interpretive center. We also talked to David Iglesias Pérez of <a href=\"http://milpositivos.com/\">Mil Positivos</a>, an adventure travel planning service that runs mountain tours throughout northern Spain. With suggestions from the two of them, here are our favorite highlights of gorgeous Green Spain, and some insight on how a guide can help you create a personalized experience – no matter what kind of adventure you’re looking for."
          },
          "id": "cdd478ff-326d-495f-b35c-92d9c59133c3",
          "type": "paragraph"
        },
        {
          "data": {
            "flip": false,
            "images": [
              {
                "alt": "Cathedral of Santiago de Compostela.",
                "caption": "Cathedral of Santiago de Compostela.",
                "id": "7v14ujiurt14n8be1kfj480g4k",
                "src": "https://lp-cms-production.imgix.net/2025-01/LonelyPlanetNorthSpain2024DAY10SantiagoDeCompostela00008.jpg?",
                "title": "media:canto_dam:72f1c00a-aa67-4782-9985-1b78b1fbc35c"
              },
              {
                "alt": "Estefanía Gonzalez leads the way through a ruin in the Fragas do Eume.",
                "caption": "Estefanía Gonzalez leads the way through a ruin in the Fragas do Eume.",
                "id": "qico3f73nh3r123ri7r6fhtf60",
                "src": "https://lp-cms-production.imgix.net/2025-01/fragas-do-eume-Galicia-Blake-Horn-A7403364.jpg?",
                "title": "media:canto_dam:90a16957-3a82-4678-ac31-4884ffc310b6"
              },
              {
                "alt": "Fresh seafood at Mercado de Abastos.",
                "caption": "Fresh seafood at Mercado de Abastos. Credits clockwise from top left: Coke Bartrina for Lonely Planet, Blake Horn for Lonely Planet, Coke Bartrina for Lonely Planet, Blake Horn for Lonely Planet",
                "id": "1ap991prtt3ctc75v539522f12",
                "src": "https://lp-cms-production.imgix.net/2025-01/LonelyPlanetNorthSpain2024DAY09ParqueCorcubedo00014.jpg?",
                "title": "media:canto_dam:6dabdb8d-0443-4a93-9121-e55e27e02be8"
              },
              {
                "alt": "Playa de Lagoa in El Parque Natural Dunas de Corrubedo.",
                "caption": "Playa de Lagoa in El Parque Natural Dunas de Corrubedo.",
                "id": "u2c66dvpq93atco7lmsr8qci5v",
                "src": "https://lp-cms-production.imgix.net/2025-01/spain-blake-horn-A7401750.jpg?",
                "title": "media:canto_dam:3e1bf88d-8db4-4283-8074-c8a8c6b4df18"
              }
            ]
          },
          "id": "EUeiu-9CLW",
          "type": "canto_collage"
        },
        {
          "data": {
            "level": 2,
            "text": "Galicia"
          },
          "id": "b6f4e149-055d-428a-8b41-188e4f5403f5",
          "type": "header"
        },
        {
          "data": {
            "text": "Galicia is known for the incomparable atmosphere of Santiago de Compostela – the end point of the Camino de Santiago pilgrim trails – as well as its stunning coastal landscape, and perhaps the most delicious seafood in Europe. Its unique brand of Celtic and Spanish culture, rich history and charming traditions make it an authentic destination for culture aficionados, nature lovers and gastronomy enthusiasts alike."
          },
          "id": "20ffc19a-ffff-42ce-936a-f9d4969e3ea1",
          "type": "paragraph"
        },
        {
          "data": {
            "items": [
              "<a href=\"https://www.lonelyplanet.com/spain/cantabria-asturias-and-galicia/santiago-de-compostela\">Santiago de Compostela</a>: This unique city is imbued with the aura of a millennium’s worth of journeys. ",
              "Costa da Morte: This is the eerily beautiful Coast of Death, the westernmost outpost of mainland Spain, where mysteries and legends abound. ",
              "O Courel: Its mountains, forests, waterfalls, rivers, fortified villages and medieval remains make it a place of unparalleled beauty that leaves no one indifferent.",
              "<a href=\"https://www.lonelyplanet.com/articles/cies-islands-spain\">Illas Cíes</a>: These three spectacular islands are home to some of Galicia's most splendid beaches. Camp in a dreamlike and highly protected environment.",
              "Riás Altas: The wild, rugged coastline and southern Europe’s highest ocean cliffs are awe-inspiring from the Garita de Herbeira viewpoint.",
              "Fragas do Eume: This natural park is one of the best-preserved Atlantic forests in Europe and a peaceful retreat with waterfalls, swinging bridges and endless views.",
              "Seafood: The fruits of the ocean and coastline, from tender seabass, turbot or hake to octopus, squid, crabs, cockles, scallops, mussels and countless other crustaceans, are sublime. Try the pulpo á feira (octopus Galician style).<br>\n\t "
            ],
            "style": "unordered"
          },
          "id": "cb1262e2-2065-496b-ad2a-b0bbbd6f3494",
          "type": "list"
        },
        {
          "data": {
            "text": "What the guides say: “A tour of the Ribeira Sacra is a perfect, complete experience that captures all the diversity and beauty of northern Spain. Here you can combine hiking trails, a riverboat ride in Sil Canyon, visits to wineries, Romanesque art at the monasteries, gastronomy and history – including archaeological sites and charming villages.” – Estefanía"
          },
          "id": "4b102f1e-c0a2-4244-8d21-7c95cc464647",
          "type": "paragraph"
        },
        {
          "data": {
            "images": [
              {
                "alt": "Percebeiros prepare to depart from the fishing town of Corme, on the Costa da Morte.",
                "caption": "Percebeiros prepare to depart from the fishing town of Corme, on the Costa da Morte. Blake Horn for Lonely Planet",
                "id": "i5mmliblsp27ffjs583tapl45v",
                "src": "https://lp-cms-production.imgix.net/2025-01/corme-galicia-Blake-Horn-A7403508.jpg?",
                "title": "media:canto_dam:ff8d1538-7dba-4666-95df-b657746ac09e"
              },
              {
                "alt": "The barnacle pickers will be filling these baskets with the crustacean delicacies.",
                "caption": "The barnacle pickers will be filling these baskets with the crustacean delicacies. Blake Horn for Lonely Planet",
                "id": "nrm2d4j2g12ut0n9uccbdk190s",
                "src": "https://lp-cms-production.imgix.net/2025-01/corme-galicia-Blake-Horn-A7403518.jpg?",
                "title": "media:canto_dam:ceeb35b7-e9bb-464b-a00b-0c4a8b3db258"
              },
              {
                "alt": "Roberto Vidal Pombo, a percebeiros, hones the blade of his scraper before setting out.",
                "caption": "Roberto Vidal Pombo, a percebeiros, hones the blade of his scraper before setting out.",
                "id": "akrtupbb6p5th504n3qh2kvo47",
                "src": "https://lp-cms-production.imgix.net/2025-01/costa-morte-galicia-Blake-Horn-A7403697.jpg?",
                "title": "media:canto_dam:c12d8d08-233f-43ef-947f-0bda055c1610"
              },
              {
                "alt": "Galicia is one of the best places in the world to collect percebes. Blake Horn for Lonely Planet",
                "caption": "Galicia is one of the best places in the world to collect percebes. Blake Horn for Lonely Planet",
                "id": "ied7qjgnd54td57oc9on94j664",
                "src": "https://lp-cms-production.imgix.net/2025-01/costa-morte-galicia-Blake-Horn-A7404201.jpg?",
                "title": "media:canto_dam:50848ebb-054e-43ac-a294-c04b596b8e2f"
              },
              {
                "alt": "Harvesting percebes is a treacherous tradition.",
                "caption": "Harvesting percebes is a treacherous tradition. Blake Horn for Lonely Planet",
                "id": "qrfacvc9097cb9bo5utkt2b826",
                "src": "https://lp-cms-production.imgix.net/2025-01/costa-morte-galicia-Blake-Horn-A7404864.jpg?",
                "title": "media:canto_dam:273f00bd-df80-4dd9-b9c0-f088460c0451"
              },
              {
                "alt": "Culinary adventures like these are a hidden gem.",
                "caption": "Culinary adventures like these are a hidden gem. Blake Horn for Lonely Planet",
                "id": "k9imsq4g9p7uf8v04eiaki4g06",
                "src": "https://lp-cms-production.imgix.net/2025-01/costa-morte-galicia-Blake-Horn-A7405082.jpg?",
                "title": "media:canto_dam:80018fc1-46f3-4c7a-ae41-1402e34f9bf5"
              },
              {
                "alt": "May 9, 2024: The Costa da Morte (Coast of Death) got its name from all the people who have died from shipwrecked boats on the shoreline.  We follow Roberto Vidal Pombo, who is a percebeiro, a barnacle picker.  Roberto and his brother go out to rocks off the coast where they pick percebes (barnacles).\n\nAfterward, we go to Restaurante Miramar de Corme where we take pics of seafood dishes.\nSpain Marketing 1379722",
                "caption": "Each bite of these delicious crustaceans is a testament to both nature's bounty and human skill. Blake Horn for Lonely Planet",
                "id": "soi3sp12i55s7bakfqpqmr0c32",
                "src": "https://lp-cms-production.imgix.net/2025-01/costa-morte-galicia-Blake-Horn-A7405292.jpg?",
                "title": "media:canto_dam:115f0492-7069-4946-8d66-3541e4da950b"
              }
            ]
          },
          "id": "UomWgbFgvj",
          "type": "canto_carousel"
        },
        {
          "data": {
            "level": 3,
            "text": "Don’t miss: Percebes"
          },
          "id": "fcb78ebe-2f6e-43aa-8c04-a18bfea835a0",
          "type": "header"
        },
        {
          "data": {
            "text": "Galicia is one of the finest spots on the planet to sample those tender, unusual crustaceans known as <i>percebes</i>. In a death-defying tradition, <i>percebes</i> (also known as goose barnacles) are harvested by skilled divers from the jagged cliffs on the Costa da Morte using methods passed down through generations. The barnacles cling strongly below the waterline, and the best come from the most dangerous places, where the waves crash hardest against the rocks: that’s where the muscle you’ll eventually eat is particularly strong and developed."
          },
          "id": "5555e5c3-4002-4ec2-8d75-921b5d7eb197",
          "type": "paragraph"
        },
        {
          "data": {
            "text": "All that dangerous work is worth it. The flavor of <i>percebes</i> is justifiably celebrated – the juicy snap, creamy taste and faintly salty finish is like a kiss from the sea. They’re usually served with just a quick boil or steam in sea or salt water, but some places add a garlic-and-parsley sauce. The first person to try percebes sure was one adventurous individual, but we're glad they did."
          },
          "id": "debb5c3e-b145-4ebe-b405-57869c810ad5",
          "type": "paragraph"
        },
        {
          "data": {
            "flip": true,
            "images": [
              {
                "alt": "Tapping a cask of Green Spain's famous cider.",
                "caption": "Tapping a cask of Green Spain's famous cider.",
                "id": "n9atfl0v7d7vd0ek1ipct54r03",
                "src": "https://lp-cms-production.imgix.net/2025-01/CROP-northern-Spain-train-jamesjackman2406101004794.jpg?",
                "title": "media:canto_dam:3b5e4134-322f-4559-a48f-b629712298b9"
              },
              {
                "alt": "Asturias has some of the most picturesque landscapes in all of Spain.",
                "caption": "Asturias has some of the most picturesque landscapes in all of Spain.",
                "id": "0ebalqu5vd0r530q3q0f27vp72",
                "src": "https://lp-cms-production.imgix.net/2025-01/Villaviciosa-asturias-spain-jack-pearce-DJI202405072215200104D.jpg?",
                "title": "media:canto_dam:9a3e2a37-da84-4874-b32a-266e43426185"
              },
              {
                "alt": "The picture-perfect fishing ports of Asturias, like Luarca, are charming as well.",
                "caption": "The picture-perfect fishing ports of Asturias, like Luarca, are charming as well. Clockwise from top left: James Jackman for Lonely Planet, Jack Pearce for Lonely Planet, Coke Bartrina for Lonely Planet (2)",
                "id": "efl3io5osh64jb1vg8s9s6qo1c",
                "src": "https://lp-cms-production.imgix.net/2025-01/LonelyPlanetNorthSpain2024DAY08Luarca00002.jpg?",
                "title": "media:canto_dam:2186b3a3-2204-41ed-b273-7ba18f5f7f8b"
              },
              {
                "alt": "The beaches in Asturias are known for their rugged beauty, pristine sands, and crystal-clear waters.",
                "caption": "The beaches in Asturias are known for their rugged beauty, pristine sands, and crystal-clear waters.",
                "id": "8r1jdpp7bh6ul2cjnvm5qel612",
                "src": "https://lp-cms-production.imgix.net/2025-01/LonelyPlanetNorthSpain2024DAY08Luarca00046.jpg?",
                "title": "media:canto_dam:4b2b74d0-c74f-4bcc-bf12-e7db3b1291c7"
              }
            ]
          },
          "id": "XoQHuwWi2p",
          "type": "canto_collage"
        },
        {
          "data": {
            "level": 2,
            "text": "Asturias"
          },
          "id": "df854408-dc43-46ae-b142-13fc1bfcd97c",
          "type": "header"
        },
        {
          "data": {
            "text": "Talk about something for everyone! Asturias is a land full of contrasts – colorful fishing ports and more than 200 beaches; soaring mountains and deep valleys; pre-Romanesque architecture and cultured cities; fizzy cider and pungent cheeses."
          },
          "id": "e3ebba56-0ca0-4e34-81b6-8d0411dec4d3",
          "type": "paragraph"
        },
        {
          "data": {
            "items": [
              "<a href=\"https://www.lonelyplanet.com/spain/asturias/oviedo\">Oviedo</a>: A fun, sophisticated city with a stash of intriguing sights, some excellent restaurants and a lively population. Architecture fans will love the cathedral and pre-Romanesque buildings.",
              "Cider: Asturians have been pouring cider since as far back as the 8th century, and the province’s <i>sidrerías</i> (cider bars) – especially in <a href=\"https://www.lonelyplanet.com/spain/asturias/gijon\">Gijón</a> – are always a lively scene",
              "<a href=\"https://www.lonelyplanet.com/spain/asturias/ribadesella/attractions/cueva-de-tito-bustillo/a/poi-sig/1130948/1315836\">Cueva de Tito Bustillo</a>: This UNESCO-listed cave contains some of Spain’s finest cave art, including superb horse paintings probably done around 15,000 to 10,000 BCE.",
              "Senda del Oso: For a fun outing with kids, rent bikes for a leisurely ride down this former mine railway and see if you can spot the (enclosed) Cantabrian brown bears.",
              "Parque Natural de Somiedo and Saliencia Lakes: Need more bears? You can find them here too. Five verdant valleys descend from beautiful mountain country that few foreigners reach. The view of Lago del Valle and Salienca from Picos Albos is stunning.",
              "Cudillero: Pastel-painted fishing port houses cascade down to a tiny port on a narrow inlet. Is it the most picturesque fishing village in Spain? Who are we to argue?"
            ],
            "style": "unordered"
          },
          "id": "484ea3a9-66be-4d19-9d9d-25854e16eda3",
          "type": "list"
        },
        {
          "data": {
            "text": "What the guides say: The Parque Natural Las Ubiñas-La Mesa is the perfect place to visit if you like trekking and mountaineering. You’ll climb the highest mountains of this natural park, Ubiña (Grande and Pequeña), Los Fontanes (North and South) and the Picu Fariñentu (around 8,000 feet) and stay overnight at Refugio de la Vega del Meicín in the heart of the Ubiñas massif. – David Iglesias"
          },
          "id": "31738b7b-1052-4662-b299-cef1d5aa28d4",
          "type": "paragraph"
        },
        {
          "data": {
            "flip": false,
            "images": [
              {
                "alt": "The Picos de Europa are spectacular.",
                "caption": "The Picos de Europa are spectacular.",
                "id": "rfklv15pv91it08a9s3kfnj50n",
                "src": "https://lp-cms-production.imgix.net/2025-01/COLLAGE-RM-LonelyPlanetNorthSpain2024DAY07UrrielluAndMiradorPozoDeLaOracion00049.jpg?",
                "title": "media:canto_dam:f34dfe6e-42e7-4b19-a161-385507cfcc16"
              },
              {
                "alt": "Hikers of all kinds flock to the Picos for outdoor adventures.",
                "caption": "Hikers of all kinds flock to the Picos for outdoor adventures.",
                "id": "89c6oa8vt54enatoaeuavii80i",
                "src": "https://lp-cms-production.imgix.net/2025-01/COLLAGE-RM-LonelyPlanetNorthSpain2024DAY07UrrielluAndMiradorPozoDeLaOracion00030.jpg?",
                "title": "media:canto_dam:4315782a-d53a-4c77-9517-edc88c828755"
              },
              {
                "alt": "It's carved into and through the walls of a dramatic gorge.",
                "caption": "It's carved into and through the walls of a dramatic gorge. Coke Bartrina for Lonely Planet (4)",
                "id": "80mm84tm8h6fvfnhjd7uc6501u",
                "src": "https://lp-cms-production.imgix.net/2025-01/COLLAGE-RM-LonelyPlanetNorthSpain2024DAY07RutaDelCares00049.jpg?",
                "title": "media:canto_dam:b00c5c19-38cd-4045-8db2-502a59273393"
              },
              {
                "alt": "The Ruta del Cares in particular is one of the most spectacular hikes in Spain.",
                "caption": "The Ruta del Cares in particular is one of the most spectacular hikes in Spain.",
                "id": "4v1f7g26ld24t254elql1glq5h",
                "src": "https://lp-cms-production.imgix.net/2025-01/SLIDESHOW-LonelyPlanetNorthSpain2024DAY07RutaDelCares00098.jpg?",
                "title": "media:canto_dam:faf12ca6-95c9-4c46-8c6d-2f60953448a3"
              }
            ]
          },
          "id": "mgfSgtVA3a",
          "type": "canto_collage"
        },
        {
          "data": {
            "level": 2,
            "text": "The Picos de Europa"
          },
          "id": "8446a844-1112-4854-88f2-b9628f08c44d",
          "type": "header"
        },
        {
          "data": {
            "text": "Limestone peaks, lush valleys and crystal-clear rivers make the <a href=\"https://www.lonelyplanet.com/spain/picos-de-europa/attractions/parque-nacional-de-los-picos-de-europa/a/poi-sig/1269207/1315844\">Parque Nacional de los Picos de Europa</a> a paradise for hikers, climbers and nature lovers. Among the breathtaking views and unique wildlife, there is a diverse range of outdoor activities."
          },
          "id": "49168b8c-8115-40b2-be2c-bda25c21f5ab",
          "type": "paragraph"
        },
        {
          "data": {
            "items": [
              "Fuente Dé: The ridiculously popular <a href=\"https://www.lonelyplanet.com/spain/fuente-de-southeastern-picos/attractions/teleferico-de-fuente-de/a/poi-sig/1131557/1315855\">Teleférico de Fuente Dé cable car</a> whisks people to the superb heights of the southeastern <a href=\"https://www.lonelyplanet.com/spain/picos-de-europa\">Picos</a>.",
              "Ruta del Cares: A trail is carved high into and through the rugged walls of a magnificent and dramatic gorge, with limestone peaks soaring far above.",
              "Sunset from the Collado Jermoso: This mountain refuge in the central massif is located more than 3,280 feet above the Valdéon valley. It’s the perfect place to end a day of mountaineering.",
              "Lagos de Covadonga: These two beautiful little lakes are set between absurdly picturesque peaks. Some stunning walks follow marked and looped trails.",
              "Paddling the Río Sella: Several agencies in Arriondas, Cangas de Onis and other nearby towns rent canoes, kayaks, paddles and everything else you need for a rapids-run.",
              "Casadielles: A flaky Asturian pastry filled with walnuts and anise. It comes from traditional Sephardic cooking and is a delicious way to end a day of outdoor exertion."
            ],
            "style": "unordered"
          },
          "id": "87e4d341-e82e-4e8d-8170-48ba501ce6ee",
          "type": "list"
        },
        {
          "data": {
            "text": "What the guides say: “More and more visitors are choosing to spread their stay over several days and points of interest. This allows them to explore the area in depth and enjoy the experience in a more authentic way. (Green Spain) should be enjoyed leisurely, allowing ample time to appreciate its beauty from all possible perspectives.” – Estefanía"
          },
          "id": "b3f29dcb-3201-4fe5-a653-042742d31ed8",
          "type": "paragraph"
        },
        {
          "data": {
            "flip": false,
            "images": [
              {
                "alt": "Santillana del Mar is known for its well-preserved medieval architecture.",
                "caption": "Santillana del Mar is known for its well-preserved medieval architecture. James Jackman for Lonely Planet",
                "id": "pd0vcd42ph23d71e9u8lh04g43",
                "src": "https://lp-cms-production.imgix.net/2025-01/CROP-northern-Spain-train-jamesjackman2406121006664.jpg?",
                "title": "media:canto_dam:01e2b717-ce5c-45e6-baea-79032f50fe85"
              },
              {
                "alt": "This scale replica of the Cave of Altamira reflects the beauty of the renowned cave painting.",
                "caption": "This scale replica of the Cave of Altamira reflects the beauty of the renowned cave painting. James Jackman for Lonely Planet",
                "id": "vsji52t5g10j30brr9olsis95t",
                "src": "https://lp-cms-production.imgix.net/2025-01/northern-Spain-train-jamesjackman2406121006514.jpg?",
                "title": "media:canto_dam:ad55a54d-623c-4401-8c3c-ccbcd3d36ad1"
              }
            ]
          },
          "id": "hzCmU8u3CT",
          "type": "canto_diptych"
        },
        {
          "data": {
            "level": 2,
            "text": "Cantabria"
          },
          "id": "13024aa3-62b4-4db8-8f1a-e5bf05c29c67",
          "type": "header"
        },
        {
          "data": {
            "text": "Sharing the Picos de Europa with Asturias, Cantabria draws in outdoor adventurers and nature lovers with its rugged coastline, mysterious ancient cave art, cliff-backed beaches and lush green valleys. Sturdy stone houses with red-tile roofs make road tripping here a joy, and the capital city <a href=\"https://www.lonelyplanet.com/spain/cantabria-asturias-and-galicia/santander\">Santander</a> buzzes with energy and culinary experimentation."
          },
          "id": "b3f2f8d4-ab0b-4845-b4d6-0fd4a0c2f588",
          "type": "paragraph"
        },
        {
          "data": {
            "items": [
              "Altamira: Spain’s most renowned cave paintings date back thousands of years, showcasing intricate depictions of animals and human hands.",
              "Santander: The belle epoque elegance of<a href=\"https://www.lonelyplanet.com/spain/cantabria-asturias-and-galicia/santander/attractions/playa-del-sardinero/a/poi-sig/1481750/360749\">&nbsp;Playa del Sardinero</a>, an array of bewitching <i>pintxos</i> (elaborate tapas) bars and the splashy Centro Botín arts center give Santander its character.",
              "<a href=\"https://www.lonelyplanet.com/spain/cantabria/santillana-del-mar\">Santillana del Mar</a>: This medieval jewel is in a perfect state of preservation, with its bright cobbled streets, flower-filled balconies and huddle of tanned stone and brick buildings. ",
              "<a href=\"https://www.lonelyplanet.com/spain/cantabria/comillas\">Comillas</a>: Check out the funky buildings in this small hilltop village. Its medieval center is built around cobbled plazas, and Modernista architects have found creative outlet in designing  the surrounding houses.",
              "Sardines: A Cantabrian specialty pulled from the cold water, sardines here are typically grilled over open flames and seasoned with just a touch of salt. Delicious!"
            ],
            "style": "unordered"
          },
          "id": "7cf56920-ac01-4be4-803a-ba5b351a6873",
          "type": "list"
        },
        {
          "data": {
            "text": "What the guides say: Our favorite places in the Cantabrian Mountains are its forests, beautiful, green and full of life, and its magnificent mountains, which rise abruptly from the bottom of the valleys to almost touching the sky. Local culture and traditions here have endured since ancient times... The Sephardic lifestyle, harvesting, crafts, popular knowledge, the use of the environment and the adaptation to the environment. There are many stories to tell ... legends included. – David Iglesias"
          },
          "id": "bde2063c-1c9b-4bc4-bccb-eccfea599bbe",
          "type": "paragraph"
        },
        {
          "data": {
            "flip": false,
            "images": [
              {
                "alt": "Museo Guggenheim Bilbao is one of Spain's architectural treasures.",
                "caption": "Museo Guggenheim Bilbao is one of Spain's architectural treasures.",
                "id": "37kapefj950ntd8oddef5pua7g",
                "src": "https://lp-cms-production.imgix.net/2025-01/CROP-LonelyPlanetNorthSpain2024DAY04Bilbao00034.jpg?",
                "title": "media:canto_dam:17cbba43-aed0-45d1-ba24-8693e43dce77"
              },
              {
                "alt": "Fresh fish is picked up and ready to be grilled for the diners at Elkano in Getaria.",
                "caption": "Fresh fish is picked up and ready to be grilled for the diners at Elkano in Getaria.",
                "id": "69ks184amd7v7a2p0onm00g76p",
                "src": "https://lp-cms-production.imgix.net/2025-01/LonelyPlanetNorthSpain2024DAY03ElKanoGetaria00118.jpg?",
                "title": "media:canto_dam:5dacc7d2-95db-45ab-ac40-6e7655cfa532"
              },
              {
                "alt": "The vineyards of Txomin Etxaniz winery.",
                "caption": "The vineyards of Txomin Etxaniz winery. Coke Bartrina for Lonely Planet (4)",
                "id": "peu3eav2qp6at2qevdcp097p5u",
                "src": "https://lp-cms-production.imgix.net/2025-01/LonelyPlanetNorthSpain2024DAY02Jaizkibel00003.jpg?",
                "title": "media:canto_dam:3cd9c228-d2d6-451c-a31f-05a9cf758563"
              },
              {
                "alt": "Wind your way up Monte Jaizkibel for a ruined fortress and spectacular views.",
                "caption": "Wind your way up Monte Jaizkibel for a ruined fortress and spectacular views.",
                "id": "m39omj6ued2rt2tirrg0n9fc01",
                "src": "https://lp-cms-production.imgix.net/2025-01/LonelyPlanetNorthSpain2024DAY03TxominWinery00036.jpg?",
                "title": "media:canto_dam:983bc661-a676-4a1c-919d-fa9b30a416c2"
              }
            ]
          },
          "id": "XskzHiSt9-",
          "type": "canto_collage"
        },
        {
          "data": {
            "level": 2,
            "text": "Basque Country"
          },
          "id": "55d5c89d-aa42-4eae-a3af-76fd892a4621",
          "type": "header"
        },
        {
          "data": {
            "text": "Furthest east among Green Spain’s four provinces, the Basque Country demands exploration beyond the delightful and cosmopolitan main cities of <a href=\"https://www.lonelyplanet.com/spain/aragon-basque-country-and-navarra/bilbao\">Bilbao</a>, Vitoria and <a href=\"https://www.lonelyplanet.com/spain/aragon-basque-country-and-navarra/san-sebastian\">San Sebastián</a>. Its renowned culinary scene, distinct language and traditions, and mix of mountain and coastal landscapes mean your travels here are always curious and frequently rewarded."
          },
          "id": "68a810c6-98c7-4baa-8e9c-1e93e102ddc3",
          "type": "paragraph"
        },
        {
          "data": {
            "items": [
              "Bilbao: The&nbsp;<a href=\"https://www.lonelyplanet.com/spain/basque-country/bilbao/new-town/attractions/museo-guggenheim-bilbao/a/poi-sig/419033/1342124\">Museo Guggenheim Bilbao</a>, one of Spain’s architectural treasures, is just the jewel in this city’s crown. You can find artistic inspiration down nearly every street of the Old Town.",
              "San Sebastián: Elegant art nouveau buildings look out over perfect <a href=\"https://www.lonelyplanet.com/spain/basque-country/san-sebastian/new-town-monte-igueldo/attractions/playa-de-la-concha/a/poi-sig/1208328/1342121\">Playa de la Concha</a>, green <a href=\"https://www.lonelyplanet.com/spain/basque-country/san-sebastian/parte-vieja/attractions/monte-urgull/a/poi-sig/448319/1342120\">Monte Urgull</a> rises from its edge, and fabulous <a href=\"https://www.lonelyplanet.com/articles/planning-foodie-trip-bilbao-basque-country-spain\"><i>pintxos</i></a> are down every cobbled lane. ",
              "<a href=\"https://www.lonelyplanet.com/spain/basque-country\">The Basque Coast</a>: The cultural and natural richness are on full display in coastal towns like Bermeo. At low tide, you can walk to a scenic island just offshore from picture-perfect Lekeitio.",
              "Surfing Zarautz or Mundaka: Wave riding comes with the territory on these pretty – if chilly – waterfront spots. Mundaka’s break is particularly legendary.",
              "<a href=\"https://www.lonelyplanet.com/spain/basque-country/bermeo/attractions/san-juan-de-gaztelugatxe/a/poi-sig/1514959/1315808\">San Juan de Gaztelugatxe</a>: This jaw-dropping clifftop hermitage has only grown in popularity since it was used to represent Dragonstone in the HBO shows<i> Game of Thrones</i> and <i>House of the Dragon</i>."
            ],
            "style": "unordered"
          },
          "id": "2a06fe29-d399-47c6-9d3a-8d515ae26475",
          "type": "list"
        },
        {
          "data": {
            "text": "What the guides say: “(Using a local guide) to incorporate local culture, traditions and hidden gems as much as possible is the key to a visit you’ll always remember. Passing through magical places full of secrets or curiosities, experiencing traditions firsthand and allowing yourself to feel, experience and see it with your own eyes will ensure your experience remains in your mind and heart.” – Estefanía"
          },
          "id": "90af5e1a-2ff8-4dcb-b09b-8d6bdd2af196",
          "type": "paragraph"
        }
      ],
      "editorial": "<p>Green <a href=\"https://www.lonelyplanet.com/spain\">Spain</a>'s wild coastline, gastronomic delights, charming historic towns and unique cultural identity are incomparable. Nature and tradition have blessed these four provinces (Galicia, <a href=\"https://www.lonelyplanet.com/spain/asturias\">Asturias</a>, <a href=\"https://www.lonelyplanet.com/spain/cantabria\">Cantabria</a> and <a href=\"https://www.lonelyplanet.com/spain/basque-country\">Basque Country</a>) with something for everyone, from hardcore adventurers to laid-back beachgoers.</p><p>In fact, there’s so much this northern region of Spain offers – for so many different types of travelers – that the best way to start planning is to talk to a local, passionate and expert guide.</p><p>We spoke with Estefanía Gonzalez, an Official Tourist Guide of Galicia and a cultural mediator at Parque Arqueolóxico da Cultura Castrexa, an archaeological park and interpretive center. We also talked to David Iglesias Pérez of <a href=\"http://milpositivos.com/\">Mil Positivos</a>, an adventure travel planning service that runs mountain tours throughout northern Spain. With suggestions from the two of them, here are our favorite highlights of gorgeous Green Spain, and some insight on how a guide can help you create a personalized experience – no matter what kind of adventure you’re looking for.</p><div class=\"canto-collage\">\n  <div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/LonelyPlanetNorthSpain2024DAY10SantiagoDeCompostela00008.jpg?\" alt=\"Cathedral of Santiago de Compostela.\" data-title=\"media:canto_dam:72f1c00a-aa67-4782-9985-1b78b1fbc35c\" />\n  </figure>\n  <p>Cathedral of Santiago de Compostela.</p>\n</div><div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/fragas-do-eume-Galicia-Blake-Horn-A7403364.jpg?\" alt=\"Estefanía Gonzalez leads the way through a ruin in the Fragas do Eume.\" data-title=\"media:canto_dam:90a16957-3a82-4678-ac31-4884ffc310b6\" />\n  </figure>\n  <p>Estefanía Gonzalez leads the way through a ruin in the Fragas do Eume.</p>\n</div><div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/LonelyPlanetNorthSpain2024DAY09ParqueCorcubedo00014.jpg?\" alt=\"Fresh seafood at Mercado de Abastos.\" data-title=\"media:canto_dam:6dabdb8d-0443-4a93-9121-e55e27e02be8\" />\n  </figure>\n  <p>Fresh seafood at Mercado de Abastos. Credits clockwise from top left: Coke Bartrina for Lonely Planet, Blake Horn for Lonely Planet, Coke Bartrina for Lonely Planet, Blake Horn for Lonely Planet</p>\n</div><div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/spain-blake-horn-A7401750.jpg?\" alt=\"Playa de Lagoa in El Parque Natural Dunas de Corrubedo.\" data-title=\"media:canto_dam:3e1bf88d-8db4-4283-8074-c8a8c6b4df18\" />\n  </figure>\n  <p>Playa de Lagoa in El Parque Natural Dunas de Corrubedo.</p>\n</div>\n</div><h2>Galicia</h2><p>Galicia is known for the incomparable atmosphere of Santiago de Compostela – the end point of the Camino de Santiago pilgrim trails – as well as its stunning coastal landscape, and perhaps the most delicious seafood in Europe. Its unique brand of Celtic and Spanish culture, rich history and charming traditions make it an authentic destination for culture aficionados, nature lovers and gastronomy enthusiasts alike.</p><ul><li><a href=\"https://www.lonelyplanet.com/spain/cantabria-asturias-and-galicia/santiago-de-compostela\">Santiago de Compostela</a>: This unique city is imbued with the aura of a millennium’s worth of journeys. </li><li>Costa da Morte: This is the eerily beautiful Coast of Death, the westernmost outpost of mainland Spain, where mysteries and legends abound. </li><li>O Courel: Its mountains, forests, waterfalls, rivers, fortified villages and medieval remains make it a place of unparalleled beauty that leaves no one indifferent.</li><li><a href=\"https://www.lonelyplanet.com/articles/cies-islands-spain\">Illas Cíes</a>: These three spectacular islands are home to some of Galicia's most splendid beaches. Camp in a dreamlike and highly protected environment.</li><li>Riás Altas: The wild, rugged coastline and southern Europe’s highest ocean cliffs are awe-inspiring from the Garita de Herbeira viewpoint.</li><li>Fragas do Eume: This natural park is one of the best-preserved Atlantic forests in Europe and a peaceful retreat with waterfalls, swinging bridges and endless views.</li><li>Seafood: The fruits of the ocean and coastline, from tender seabass, turbot or hake to octopus, squid, crabs, cockles, scallops, mussels and countless other crustaceans, are sublime. Try the pulpo á feira (octopus Galician style).<br>\n\t </li></ul><p>What the guides say: “A tour of the Ribeira Sacra is a perfect, complete experience that captures all the diversity and beauty of northern Spain. Here you can combine hiking trails, a riverboat ride in Sil Canyon, visits to wineries, Romanesque art at the monasteries, gastronomy and history – including archaeological sites and charming villages.” – Estefanía</p><div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/corme-galicia-Blake-Horn-A7403508.jpg?\" alt=\"Percebeiros prepare to depart from the fishing town of Corme, on the Costa da Morte.\" data-title=\"Percebeiros prepare to depart from the fishing town of Corme, on the Costa da Morte. Blake Horn for Lonely Planet\" />\n  </figure>\n  <p>Percebeiros prepare to depart from the fishing town of Corme, on the Costa da Morte. Blake Horn for Lonely Planet</p>\n</div><div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/corme-galicia-Blake-Horn-A7403518.jpg?\" alt=\"The barnacle pickers will be filling these baskets with the crustacean delicacies.\" data-title=\"The barnacle pickers will be filling these baskets with the crustacean delicacies. Blake Horn for Lonely Planet\" />\n  </figure>\n  <p>The barnacle pickers will be filling these baskets with the crustacean delicacies. Blake Horn for Lonely Planet</p>\n</div><div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/costa-morte-galicia-Blake-Horn-A7403697.jpg?\" alt=\"Roberto Vidal Pombo, a percebeiros, hones the blade of his scraper before setting out.\" data-title=\"Roberto Vidal Pombo, a percebeiros, hones the blade of his scraper before setting out.\" />\n  </figure>\n  <p>Roberto Vidal Pombo, a percebeiros, hones the blade of his scraper before setting out.</p>\n</div><div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/costa-morte-galicia-Blake-Horn-A7404201.jpg?\" alt=\"Galicia is one of the best places in the world to collect percebes. Blake Horn for Lonely Planet\" data-title=\"Galicia is one of the best places in the world to collect percebes. Blake Horn for Lonely Planet\" />\n  </figure>\n  <p>Galicia is one of the best places in the world to collect percebes. Blake Horn for Lonely Planet</p>\n</div><div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/costa-morte-galicia-Blake-Horn-A7404864.jpg?\" alt=\"Harvesting percebes is a treacherous tradition.\" data-title=\"Harvesting percebes is a treacherous tradition. Blake Horn for Lonely Planet\" />\n  </figure>\n  <p>Harvesting percebes is a treacherous tradition. Blake Horn for Lonely Planet</p>\n</div><div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/costa-morte-galicia-Blake-Horn-A7405082.jpg?\" alt=\"Culinary adventures like these are a hidden gem.\" data-title=\"Culinary adventures like these are a hidden gem. Blake Horn for Lonely Planet\" />\n  </figure>\n  <p>Culinary adventures like these are a hidden gem. Blake Horn for Lonely Planet</p>\n</div><div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/costa-morte-galicia-Blake-Horn-A7405292.jpg?\" alt=\"May 9, 2024: The Costa da Morte (Coast of Death) got its name from all the people who have died from shipwrecked boats on the shoreline.  We follow Roberto Vidal Pombo, who is a percebeiro, a barnacle picker.  Roberto and his brother go out to rocks off the coast where they pick percebes (barnacles).\n\nAfterward, we go to Restaurante Miramar de Corme where we take pics of seafood dishes.\nSpain Marketing 1379722\" data-title=\"Each bite of these delicious crustaceans is a testament to both nature's bounty and human skill. Blake Horn for Lonely Planet\" />\n  </figure>\n  <p>Each bite of these delicious crustaceans is a testament to both nature's bounty and human skill. Blake Horn for Lonely Planet</p>\n</div><h3>Don’t miss: Percebes</h3><p>Galicia is one of the finest spots on the planet to sample those tender, unusual crustaceans known as <i>percebes</i>. In a death-defying tradition, <i>percebes</i> (also known as goose barnacles) are harvested by skilled divers from the jagged cliffs on the Costa da Morte using methods passed down through generations. The barnacles cling strongly below the waterline, and the best come from the most dangerous places, where the waves crash hardest against the rocks: that’s where the muscle you’ll eventually eat is particularly strong and developed.</p><p>All that dangerous work is worth it. The flavor of <i>percebes</i> is justifiably celebrated – the juicy snap, creamy taste and faintly salty finish is like a kiss from the sea. They’re usually served with just a quick boil or steam in sea or salt water, but some places add a garlic-and-parsley sauce. The first person to try percebes sure was one adventurous individual, but we're glad they did.</p><div class=\"canto-collage\">\n  <div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/CROP-northern-Spain-train-jamesjackman2406101004794.jpg?\" alt=\"Tapping a cask of Green Spain's famous cider.\" data-title=\"media:canto_dam:3b5e4134-322f-4559-a48f-b629712298b9\" />\n  </figure>\n  <p>Tapping a cask of Green Spain's famous cider.</p>\n</div><div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/Villaviciosa-asturias-spain-jack-pearce-DJI202405072215200104D.jpg?\" alt=\"Asturias has some of the most picturesque landscapes in all of Spain.\" data-title=\"media:canto_dam:9a3e2a37-da84-4874-b32a-266e43426185\" />\n  </figure>\n  <p>Asturias has some of the most picturesque landscapes in all of Spain.</p>\n</div><div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/LonelyPlanetNorthSpain2024DAY08Luarca00002.jpg?\" alt=\"The picture-perfect fishing ports of Asturias, like Luarca, are charming as well.\" data-title=\"media:canto_dam:2186b3a3-2204-41ed-b273-7ba18f5f7f8b\" />\n  </figure>\n  <p>The picture-perfect fishing ports of Asturias, like Luarca, are charming as well. Clockwise from top left: James Jackman for Lonely Planet, Jack Pearce for Lonely Planet, Coke Bartrina for Lonely Planet (2)</p>\n</div><div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/LonelyPlanetNorthSpain2024DAY08Luarca00046.jpg?\" alt=\"The beaches in Asturias are known for their rugged beauty, pristine sands, and crystal-clear waters.\" data-title=\"media:canto_dam:4b2b74d0-c74f-4bcc-bf12-e7db3b1291c7\" />\n  </figure>\n  <p>The beaches in Asturias are known for their rugged beauty, pristine sands, and crystal-clear waters.</p>\n</div>\n</div><h2>Asturias</h2><p>Talk about something for everyone! Asturias is a land full of contrasts – colorful fishing ports and more than 200 beaches; soaring mountains and deep valleys; pre-Romanesque architecture and cultured cities; fizzy cider and pungent cheeses.</p><ul><li><a href=\"https://www.lonelyplanet.com/spain/asturias/oviedo\">Oviedo</a>: A fun, sophisticated city with a stash of intriguing sights, some excellent restaurants and a lively population. Architecture fans will love the cathedral and pre-Romanesque buildings.</li><li>Cider: Asturians have been pouring cider since as far back as the 8th century, and the province’s <i>sidrerías</i> (cider bars) – especially in <a href=\"https://www.lonelyplanet.com/spain/asturias/gijon\">Gijón</a> – are always a lively scene</li><li><a href=\"https://www.lonelyplanet.com/spain/asturias/ribadesella/attractions/cueva-de-tito-bustillo/a/poi-sig/1130948/1315836\">Cueva de Tito Bustillo</a>: This UNESCO-listed cave contains some of Spain’s finest cave art, including superb horse paintings probably done around 15,000 to 10,000 BCE.</li><li>Senda del Oso: For a fun outing with kids, rent bikes for a leisurely ride down this former mine railway and see if you can spot the (enclosed) Cantabrian brown bears.</li><li>Parque Natural de Somiedo and Saliencia Lakes: Need more bears? You can find them here too. Five verdant valleys descend from beautiful mountain country that few foreigners reach. The view of Lago del Valle and Salienca from Picos Albos is stunning.</li><li>Cudillero: Pastel-painted fishing port houses cascade down to a tiny port on a narrow inlet. Is it the most picturesque fishing village in Spain? Who are we to argue?</li></ul><p>What the guides say: The Parque Natural Las Ubiñas-La Mesa is the perfect place to visit if you like trekking and mountaineering. You’ll climb the highest mountains of this natural park, Ubiña (Grande and Pequeña), Los Fontanes (North and South) and the Picu Fariñentu (around 8,000 feet) and stay overnight at Refugio de la Vega del Meicín in the heart of the Ubiñas massif. – David Iglesias</p><div class=\"canto-collage\">\n  <div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/COLLAGE-RM-LonelyPlanetNorthSpain2024DAY07UrrielluAndMiradorPozoDeLaOracion00049.jpg?\" alt=\"The Picos de Europa are spectacular.\" data-title=\"media:canto_dam:f34dfe6e-42e7-4b19-a161-385507cfcc16\" />\n  </figure>\n  <p>The Picos de Europa are spectacular.</p>\n</div><div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/COLLAGE-RM-LonelyPlanetNorthSpain2024DAY07UrrielluAndMiradorPozoDeLaOracion00030.jpg?\" alt=\"Hikers of all kinds flock to the Picos for outdoor adventures.\" data-title=\"media:canto_dam:4315782a-d53a-4c77-9517-edc88c828755\" />\n  </figure>\n  <p>Hikers of all kinds flock to the Picos for outdoor adventures.</p>\n</div><div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/COLLAGE-RM-LonelyPlanetNorthSpain2024DAY07RutaDelCares00049.jpg?\" alt=\"It's carved into and through the walls of a dramatic gorge.\" data-title=\"media:canto_dam:b00c5c19-38cd-4045-8db2-502a59273393\" />\n  </figure>\n  <p>It's carved into and through the walls of a dramatic gorge. Coke Bartrina for Lonely Planet (4)</p>\n</div><div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/SLIDESHOW-LonelyPlanetNorthSpain2024DAY07RutaDelCares00098.jpg?\" alt=\"The Ruta del Cares in particular is one of the most spectacular hikes in Spain.\" data-title=\"media:canto_dam:faf12ca6-95c9-4c46-8c6d-2f60953448a3\" />\n  </figure>\n  <p>The Ruta del Cares in particular is one of the most spectacular hikes in Spain.</p>\n</div>\n</div><h2>The Picos de Europa</h2><p>Limestone peaks, lush valleys and crystal-clear rivers make the <a href=\"https://www.lonelyplanet.com/spain/picos-de-europa/attractions/parque-nacional-de-los-picos-de-europa/a/poi-sig/1269207/1315844\">Parque Nacional de los Picos de Europa</a> a paradise for hikers, climbers and nature lovers. Among the breathtaking views and unique wildlife, there is a diverse range of outdoor activities.</p><ul><li>Fuente Dé: The ridiculously popular <a href=\"https://www.lonelyplanet.com/spain/fuente-de-southeastern-picos/attractions/teleferico-de-fuente-de/a/poi-sig/1131557/1315855\">Teleférico de Fuente Dé cable car</a> whisks people to the superb heights of the southeastern <a href=\"https://www.lonelyplanet.com/spain/picos-de-europa\">Picos</a>.</li><li>Ruta del Cares: A trail is carved high into and through the rugged walls of a magnificent and dramatic gorge, with limestone peaks soaring far above.</li><li>Sunset from the Collado Jermoso: This mountain refuge in the central massif is located more than 3,280 feet above the Valdéon valley. It’s the perfect place to end a day of mountaineering.</li><li>Lagos de Covadonga: These two beautiful little lakes are set between absurdly picturesque peaks. Some stunning walks follow marked and looped trails.</li><li>Paddling the Río Sella: Several agencies in Arriondas, Cangas de Onis and other nearby towns rent canoes, kayaks, paddles and everything else you need for a rapids-run.</li><li>Casadielles: A flaky Asturian pastry filled with walnuts and anise. It comes from traditional Sephardic cooking and is a delicious way to end a day of outdoor exertion.</li></ul><p>What the guides say: “More and more visitors are choosing to spread their stay over several days and points of interest. This allows them to explore the area in depth and enjoy the experience in a more authentic way. (Green Spain) should be enjoyed leisurely, allowing ample time to appreciate its beauty from all possible perspectives.” – Estefanía</p>  <div>\n    <figure>\n      <img src=\"https://lp-cms-production.imgix.net/2025-01/CROP-northern-Spain-train-jamesjackman2406121006664.jpg?\" alt=\"Santillana del Mar is known for its well-preserved medieval architecture.\" data-title=\"media:canto_dam:01e2b717-ce5c-45e6-baea-79032f50fe85\" />\n    </figure>\n    <p>Santillana del Mar is known for its well-preserved medieval architecture. James Jackman for Lonely Planet</p>\n    <figure>\n      <img src=\"https://lp-cms-production.imgix.net/2025-01/northern-Spain-train-jamesjackman2406121006514.jpg?\" alt=\"This scale replica of the Cave of Altamira reflects the beauty of the renowned cave painting.\" data-title=\"media:canto_dam:ad55a54d-623c-4401-8c3c-ccbcd3d36ad1\" />\n    </figure>\n    <p>This scale replica of the Cave of Altamira reflects the beauty of the renowned cave painting. James Jackman for Lonely Planet</p>\n  </div><h2>Cantabria</h2><p>Sharing the Picos de Europa with Asturias, Cantabria draws in outdoor adventurers and nature lovers with its rugged coastline, mysterious ancient cave art, cliff-backed beaches and lush green valleys. Sturdy stone houses with red-tile roofs make road tripping here a joy, and the capital city <a href=\"https://www.lonelyplanet.com/spain/cantabria-asturias-and-galicia/santander\">Santander</a> buzzes with energy and culinary experimentation.</p><ul><li>Altamira: Spain’s most renowned cave paintings date back thousands of years, showcasing intricate depictions of animals and human hands.</li><li>Santander: The belle epoque elegance of<a href=\"https://www.lonelyplanet.com/spain/cantabria-asturias-and-galicia/santander/attractions/playa-del-sardinero/a/poi-sig/1481750/360749\">&nbsp;Playa del Sardinero</a>, an array of bewitching <i>pintxos</i> (elaborate tapas) bars and the splashy Centro Botín arts center give Santander its character.</li><li><a href=\"https://www.lonelyplanet.com/spain/cantabria/santillana-del-mar\">Santillana del Mar</a>: This medieval jewel is in a perfect state of preservation, with its bright cobbled streets, flower-filled balconies and huddle of tanned stone and brick buildings. </li><li><a href=\"https://www.lonelyplanet.com/spain/cantabria/comillas\">Comillas</a>: Check out the funky buildings in this small hilltop village. Its medieval center is built around cobbled plazas, and Modernista architects have found creative outlet in designing  the surrounding houses.</li><li>Sardines: A Cantabrian specialty pulled from the cold water, sardines here are typically grilled over open flames and seasoned with just a touch of salt. Delicious!</li></ul><p>What the guides say: Our favorite places in the Cantabrian Mountains are its forests, beautiful, green and full of life, and its magnificent mountains, which rise abruptly from the bottom of the valleys to almost touching the sky. Local culture and traditions here have endured since ancient times... The Sephardic lifestyle, harvesting, crafts, popular knowledge, the use of the environment and the adaptation to the environment. There are many stories to tell ... legends included. – David Iglesias</p><div class=\"canto-collage\">\n  <div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/CROP-LonelyPlanetNorthSpain2024DAY04Bilbao00034.jpg?\" alt=\"Museo Guggenheim Bilbao is one of Spain's architectural treasures.\" data-title=\"media:canto_dam:17cbba43-aed0-45d1-ba24-8693e43dce77\" />\n  </figure>\n  <p>Museo Guggenheim Bilbao is one of Spain's architectural treasures.</p>\n</div><div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/LonelyPlanetNorthSpain2024DAY03ElKanoGetaria00118.jpg?\" alt=\"Fresh fish is picked up and ready to be grilled for the diners at Elkano in Getaria.\" data-title=\"media:canto_dam:5dacc7d2-95db-45ab-ac40-6e7655cfa532\" />\n  </figure>\n  <p>Fresh fish is picked up and ready to be grilled for the diners at Elkano in Getaria.</p>\n</div><div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/LonelyPlanetNorthSpain2024DAY02Jaizkibel00003.jpg?\" alt=\"The vineyards of Txomin Etxaniz winery.\" data-title=\"media:canto_dam:3cd9c228-d2d6-451c-a31f-05a9cf758563\" />\n  </figure>\n  <p>The vineyards of Txomin Etxaniz winery. Coke Bartrina for Lonely Planet (4)</p>\n</div><div>\n  <figure>\n    <img src=\"https://lp-cms-production.imgix.net/2025-01/LonelyPlanetNorthSpain2024DAY03TxominWinery00036.jpg?\" alt=\"Wind your way up Monte Jaizkibel for a ruined fortress and spectacular views.\" data-title=\"media:canto_dam:983bc661-a676-4a1c-919d-fa9b30a416c2\" />\n  </figure>\n  <p>Wind your way up Monte Jaizkibel for a ruined fortress and spectacular views.</p>\n</div>\n</div><h2>Basque Country</h2><p>Furthest east among Green Spain’s four provinces, the Basque Country demands exploration beyond the delightful and cosmopolitan main cities of <a href=\"https://www.lonelyplanet.com/spain/aragon-basque-country-and-navarra/bilbao\">Bilbao</a>, Vitoria and <a href=\"https://www.lonelyplanet.com/spain/aragon-basque-country-and-navarra/san-sebastian\">San Sebastián</a>. Its renowned culinary scene, distinct language and traditions, and mix of mountain and coastal landscapes mean your travels here are always curious and frequently rewarded.</p><ul><li>Bilbao: The&nbsp;<a href=\"https://www.lonelyplanet.com/spain/basque-country/bilbao/new-town/attractions/museo-guggenheim-bilbao/a/poi-sig/419033/1342124\">Museo Guggenheim Bilbao</a>, one of Spain’s architectural treasures, is just the jewel in this city’s crown. You can find artistic inspiration down nearly every street of the Old Town.</li><li>San Sebastián: Elegant art nouveau buildings look out over perfect <a href=\"https://www.lonelyplanet.com/spain/basque-country/san-sebastian/new-town-monte-igueldo/attractions/playa-de-la-concha/a/poi-sig/1208328/1342121\">Playa de la Concha</a>, green <a href=\"https://www.lonelyplanet.com/spain/basque-country/san-sebastian/parte-vieja/attractions/monte-urgull/a/poi-sig/448319/1342120\">Monte Urgull</a> rises from its edge, and fabulous <a href=\"https://www.lonelyplanet.com/articles/planning-foodie-trip-bilbao-basque-country-spain\"><i>pintxos</i></a> are down every cobbled lane. </li><li><a href=\"https://www.lonelyplanet.com/spain/basque-country\">The Basque Coast</a>: The cultural and natural richness are on full display in coastal towns like Bermeo. At low tide, you can walk to a scenic island just offshore from picture-perfect Lekeitio.</li><li>Surfing Zarautz or Mundaka: Wave riding comes with the territory on these pretty – if chilly – waterfront spots. Mundaka’s break is particularly legendary.</li><li><a href=\"https://www.lonelyplanet.com/spain/basque-country/bermeo/attractions/san-juan-de-gaztelugatxe/a/poi-sig/1514959/1315808\">San Juan de Gaztelugatxe</a>: This jaw-dropping clifftop hermitage has only grown in popularity since it was used to represent Dragonstone in the HBO shows<i> Game of Thrones</i> and <i>House of the Dragon</i>.</li></ul><p>What the guides say: “(Using a local guide) to incorporate local culture, traditions and hidden gems as much as possible is the key to a visit you’ll always remember. Passing through magical places full of secrets or curiosities, experiencing traditions firsthand and allowing yourself to feel, experience and see it with your own eyes will ensure your experience remains in your mind and heart.” – Estefanía</p>",
      "slug": "guide-to-green-spain",
      "title": "A guide to Green Spain: The best of the northern region"
    }
  }
}

Key Observations from Current Implementation

Section titled “Key Observations from Current Implementation”
  1. Block Structure: All blocks follow consistent { id, type, data } structure across all block types
  2. Field Naming: Current CAPI uses text field for paragraph content, while new implementation uses contentHtml/innerHtml.
  3. List Format: Uses items array with style property ("unordered" or "ordered")
  4. Rich Media Blocks:
    • canto_image: Single images with comprehensive metadata
    • canto_collage: Multiple images with flip property and images array
    • canto_carousel: Image carousel with multiple images in sequence
  5. Content Blocks: Standard text blocks (paragraph, header with levels, list with items/style)
  6. Image Metadata: Comprehensive data including id, src, alt, caption, title for all image types
  7. ID Generation: Predictable ID patterns (hdr-a1, p-a2, list-a1, img-xyz, etc.)
  8. Dual Output: Both structured contentBlocks and concatenated editorial HTML

Migration Considerations

Section titled “Migration Considerations”

When implementing the new transformer, ensure:

  • Backward compatibility with existing CAPI consumers
  • Field mapping strategy for transitioning from text to contentHtml/innerHtml
  • Rich media support for canto_collage and canto_carousel block types
  • Image array handling for complex media blocks with multiple images
  • Layout properties like flip for collage variations
  • Testing coverage for all block types currently in production (including media blocks)
  • Performance parity with existing CAPI response times for Rakiura and Kakado

Block Types & Mapping

Section titled “Block Types & Mapping”

Note: All blocks follow the consistent structure: { id: string, type: string, data: object }

Rich Text Node / Linked EntryOutput TypeData FieldsHTML Fragment in contentHtml
heading-1 … heading-6headerlevel (1–6), contentHtml (e.g., <h2>…</h2>), innerHtml (inner content with formatting)Same as contentHtml field
paragraphparagraphcontentHtml (complete <p>…</p>), innerHtml (inner content with formatting)Same as contentHtml field
unordered-list / ordered-listliststyle: "unordered" or "ordered", items: string[] (each item is HTML string, e.g., <strong>…</strong>)<ul> or <ol> with <li> items
embedded-entry-block with ImageAssetcanto_imagesrc, alt, caption, title<figure><img …/><caption>…</caption></figure>
embedded-entry-block with ImageCollagecanto_collageflip (boolean), images (array of image objects with src, alt, caption, id, title)Multiple <figure> elements in collage layout
embedded-entry-block with ImageCarouselcanto_carouselimages (array of image objects with src, alt, caption, id, title)Carousel container with multiple <figure> elements
embedded-entry-block with Quotequotetext, caption (e.g., ”— Author”)<blockquote>…<footer>…</footer></blockquote>
embedded-entry-block with JourneysDestinationjourneys_destinationtitle, url, requestUrl, image (with imageUrl, imageCaption)Custom journeys destination widget with image and CTA
embedded-entry-block or embedded-resource-block with Tiptiptitle, contentHtml (complete HTML), innerHtml (inner content with formatting)<aside data-type="tip"><h4>…</h4><p>…</p></aside>
tabletablecontentHtml (complete table HTML), innerHtml (inner table content)Complete <table> with <tr>, <th>, <td> elements
hr (horizontal rule)hrNo additional data fields<hr />
embedded-resource-block unknown/unfetchedunresolved_entryreason, optional metaMinimal placeholder (e.g., <!-- unresolved entry -->)

Important Notes

Section titled “Important Notes”
  • Block Structure: All blocks must follow a consistent format: { id: string, type: string, data: object }
  • List Format: Use items array with style property ("unordered" or "ordered") to match CAPI exactly
  • Headings & paragraphs: Always provide two content fields: contentHtml (complete HTML with tags) and innerHtml (inner content with formatting)
  • Tips (rich text blocks): Include contentHtml and innerHtml fields for consistency
  • innerHtml behavior: Follows DOM standard - preserves inner formatting but removes the outer wrapper tag
  • Consistent HTML output: Each block type produces predictable HTML fragments

Transformation Rules

Section titled “Transformation Rules”

Content Field Types

Section titled “Content Field Types”

Content fields vary by block type:

Headings & Paragraphs:

  • contentHtml: Complete HTML including outer wrapper tags
    • Example: <h2>Welcome to <strong>Paris</strong></h2>
  • innerHtml: Inner HTML content with formatting, excluding outer wrapper tags (follows DOM innerHTML standard)
    • Example: Welcome to <strong>Paris</strong>

Tips (rich text blocks):

  • contentHtml: Complete HTML including outer wrapper tags
  • innerHtml: Inner HTML content with formatting, excluding outer wrapper tags

Inline Marks & Links

Section titled “Inline Marks & Links”
  • Preserve <em>, <strong>, and <a href="…"> during HTML conversion
  • Wrap paragraph text in <p>…</p>
  • Wrap headings in <h{level}>…</h{level}>

Lists

Section titled “Lists”
  • Build list.items as HTML strings for each <li> content (preserve inline marks)
  • For bodyHtml, wrap items with <li> and the whole list with <ul> or <ol>

Images (canto_image)

Section titled “Images (canto_image)”
  • HTML fragment uses <figure><img … /><caption>…</caption></figure>
  • Field mapping:
    • imageUrl → src
    • imageDescription → alt
    • imageCaption → caption

Image Collages (canto_collage)

Section titled “Image Collages (canto_collage)”
  • Multiple images arranged in a collage layout
  • Contains flip boolean property for layout variation
  • images array contains multiple image objects, each with:
    • src, alt, caption, id, title fields
  • HTML output: Multiple <figure> elements with appropriate layout classes
Section titled “Image Carousels (canto_carousel)”
  • Sequential display of multiple images in carousel format
  • images array contains multiple image objects with same structure as collages
  • HTML output: Carousel container with navigation and multiple <figure> elements

Quotes (quote)

Section titled “Quotes (quote)”
  • text is plain text
  • caption prefixed with em dash in HTML footer

Tips (tip)

Section titled “Tips (tip)”
  • Convert Tip’s internal body.json to both content fields: contentHtml and innerHtml
  • Strip any URN/ID from final data
  • Include title, contentHtml (complete HTML), and innerHtml (inner content with formatting)

Journeys Destinations (journeys_destination)

Section titled “Journeys Destinations (journeys_destination)”
  • Renders a custom journeys destination widget with:
    • Destination title from title field
    • Background image from image.imageUrl
    • Call-to-action using requestUrl (not the simple url)
    • Responsive design with desktop and mobile layouts
    • Analytics tracking for user interactions
  • Data mapping:
    • title → destination name display
    • image.imageUrl → background image
    • requestUrl → CTA link destination
    • Component handles UTM parameters and tracking automatically

Tables (table)

Section titled “Tables (table)”
  • Convert table structure to both content fields: contentHtml and innerHtml
  • Preserve table headers (th), data cells (td), and row structure (tr)
  • contentHtml includes complete <table> wrapper
  • innerHtml contains only the inner table content (rows and cells)

Horizontal Rules (hr)

Section titled “Horizontal Rules (hr)”
  • Simple self-closing tag with no additional data fields
  • Renders as <hr /> in contentHtml output

Full Body contentHtml Generation

Section titled “Full Body contentHtml Generation”
  1. Concatenation: Combine each block’s HTML fragment in content order (use the contentHtml field for text blocks)
  2. Validation: Ensure resulting string contains valid, well-formed HTML segments
  3. Consistency: Maintain proper nesting and structure

ID Generation

Section titled “ID Generation”
  • Use predictable prefixes for debugging and stable snapshots:
    • Headers: hdr-<n>
    • Paragraphs: p-<n>
    • Images: img-<sysId>
    • Tips: tip-<sysId>

Error Handling

Section titled “Error Handling”

Unresolved Entries

Section titled “Unresolved Entries”

If an entry fails to resolve, output:

{
  "type": "unresolved_entry",
  "id": "unres-<hash>",
  "data": {
    "reason": "fetch_failed"
  }
}

In contentHtml, insert a harmless placeholder comment:

<!-- unresolved entry -->

HTML Tag Support & Allow-List

Section titled “HTML Tag Support & Allow-List”

Current Website Support

Section titled “Current Website Support”

The following HTML tags are currently supported and rendered by the website:

Block Elements

Section titled “Block Elements”
  • Headings: h1, h2, h3, h4, h5, h6
  • Text blocks: p (paragraph), blockquote (quote)
  • Lists: ul, ol, li
  • Tables: table, tr, th, td
  • Separators: hr (horizontal rule)
  • Media: figure, img, caption
  • Layout: aside (for tips), footer

Inline Elements & Marks

Section titled “Inline Elements & Marks”
  • Links: a (hyperlink)
  • Text formatting:
    • strong, b (bold)
    • em, i (italic)
    • u (underline)
    • pre (code formatting)

Rich Text Field Capabilities

Section titled “Rich Text Field Capabilities”

Contentful’s Rich Text field supports additional formatting options that could be implemented:

Currently Unsupported (Potential Expansions)

Section titled “Currently Unsupported (Potential Expansions)”
  • sub (subscript) - Useful for chemical formulas, mathematical expressions
  • sup (superscript) - Useful for footnotes, ordinal numbers, mathematical notation

Mapping from Rich Text to HTML Tags

Section titled “Mapping from Rich Text to HTML Tags”
// Block elements
"h1" => BLOCKS.HEADING_1
"h2" => BLOCKS.HEADING_2
"h3" => BLOCKS.HEADING_3
"h4" => BLOCKS.HEADING_4
"h5" => BLOCKS.HEADING_5
"h6" => BLOCKS.HEADING_6
"hr" => BLOCKS.HR
"li" => BLOCKS.LIST_ITEM
"ol" => BLOCKS.OL_LIST
"p" => BLOCKS.PARAGRAPH
"blockquote" => BLOCKS.QUOTE
"table" => BLOCKS.TABLE
"td" => BLOCKS.TABLE_CELL
"th" => BLOCKS.TABLE_HEADER_CELL
"tr" => BLOCKS.TABLE_ROW
"ul" => BLOCKS.UL_LIST


// Inline marks
"b" => MARKS.BOLD
"strong" => MARKS.BOLD
"pre" => MARKS.CODE
"i" => MARKS.ITALIC
"em" => MARKS.ITALIC
"sub" => MARKS.SUBSCRIPT      // ⚠️ Not currently supported
"sup" => MARKS.SUPERSCRIPT    // ⚠️ Not currently supported
"u" => MARKS.UNDERLINE
"a" => INLINES.HYPERLINK

Expansion Considerations

Section titled “Expansion Considerations”

High Priority for Implementation

Section titled “High Priority for Implementation”
  • Subscript (sub) - Essential for scientific content, chemical formulas
  • Superscript (sup) - Important for footnotes, mathematical notation

Implementation Requirements

Section titled “Implementation Requirements”

To support additional tags, the following components need updates:

  1. Frontend rendering - CSS styles and component support
  2. Content transformation - Update this transformer to handle new marks
  3. Editorial workflow - Ensure content editors can use new formatting
  4. QA testing - Verify rendering across all platforms (web, mobile, email)

Current Allow-List (Production)

Section titled “Current Allow-List (Production)”

Block elements: h1, h2, h3, h4, h5, h6, p, ul, ol, li, blockquote, table, tr, th, td, hr, figure, img, caption, aside, footer

Inline elements: a, strong, b, em, i, u, pre

Security & Sanitization

Section titled “Security & Sanitization”

Input Sanitization

Section titled “Input Sanitization”
  • Sanitize input where necessary (URLs, unexpected inline HTML)
  • Encode text nodes before wrapping in tags to prevent injection
  • Strip or escape any HTML tags not in the current allow-list

Security Notes

Section titled “Security Notes”
  • All HTML output should be validated against the current allow-list
  • URLs in href attributes should be validated and sanitized
  • Content from external sources should be treated as untrusted and sanitized appropriately