Developer Docs — PuzzleCast

Quick Start

Embedding a PuzzleCast widget takes just one line of HTML. Copy the iframe code and paste it into your page.

Basic Example

        
        <iframe
  src="https://a2zpuzzles.com/widgets/word-search-widget.html"
  width="100%"
  height="500"
  frameborder="0"
  title="Daily Word Search"
></iframe>
      

That's it! The widget will render inside the iframe, responsive to the container width.

Available Widgets

Widget	URL	Recommended Height
Word Search	`/widgets/word-search-widget.html`	500px
Mini Crossword	`/widgets/crossword-widget.html`	600px
Trivia Quiz	`/widgets/trivia-widget.html`	500px
Sudoku	`/widgets/sudoku-widget.html`	650px

All widget URLs are prefixed with https://a2zpuzzles.com

Customization Options

Width & Height

Set width to 100% for responsive behavior, or use a fixed pixel value. Adjust height based on the widget type (see table above).

Container Styling

Wrap the iframe in a styled container to match your site's design:

        
        <div style="max-width:600px; margin:0 auto; border-radius:12px; overflow:hidden; box-shadow:0 2px 12px rgba(0,0,0,.1)">
  <iframe
    src="https://a2zpuzzles.com/widgets/sudoku-widget.html"
    width="100%"
    height="650"
    frameborder="0"
  ></iframe>
</div>
      

Theme (Coming Soon)

URL parameters for light/dark theme customization are on our roadmap. Stay tuned!

        <iframe src="...widget.html?theme=dark&accent=ff6b6b"></iframe>
      

Best Practices

Always include a descriptive title attribute on the iframe for accessibility.
Use loading="lazy" if the widget is below the fold to improve page speed.
Set width="100%" for responsive behavior.
Wrap the iframe in a container with max-width to prevent it from stretching too wide on large screens.
Do not remove or hide the "Powered by A2Z Puzzles" attribution link.

API (Coming Soon)

We are developing a REST API that will allow you to:

Fetch daily puzzle data as JSON
Generate custom puzzles with parameters (grid size, difficulty, word lists)
Track engagement metrics for embedded widgets
Access puzzle archives

API documentation will be available here when the service launches. Contact us if you'd like early access.

FAQ

Is it really free?

Yes! All widgets are free to embed. We may introduce premium widgets with advanced customization in the future, but the core widgets will always remain free.

Can I use these widgets on a commercial website?

Absolutely. You can embed our widgets on any website, including commercial sites, blogs, and news portals.

Do the widgets show ads?

Currently, widgets do not display ads. If we introduce ads in the future, they will be minimal and non-intrusive.

How often do puzzles update?

Puzzle content is designed to refresh daily. The word search generates a random puzzle each time it loads, while crossword and sudoku puzzles are rotated on a daily schedule.

Can I customize the widget's appearance?

Currently, widgets use a clean default theme that works well on most sites. Theme customization via URL parameters is on our roadmap.

What about GDPR/privacy?

Our widgets do not use cookies or collect personal data. No tracking scripts are loaded inside widget iframes.

Developer Documentation