Embed Widgets Documentation

What are Embeddable Tool Widgets?

Akousa Embed lets you place any of the platform's 522 tools directly on your own website, blog, or documentation as a fully functional iframe widget. Visitors interact with the tool without leaving your page — entering data, processing it, and downloading results right inside the embed.

The embed system is designed for webmasters who want to add interactive utility to their content. No API key, no registration, and no attribution is required. Every embed is free, unlimited, and customizable with language and theme parameters.

How to Embed a Tool

1. 1Visit the Embed Gallery at /embed-gallery and browse all available tools. Preview each widget and copy the iframe snippet.
2. 2Customize the embed URL with parameters: ?lang=tr for Turkish, ?theme=dark for dark mode, or combine both — ?lang=fr&theme=dark.
3. 3Paste the iframe code into your HTML, CMS, or documentation platform. The widget loads securely and adapts to the container width.

Example Embed Code

<iframe
  src="https://akousa.net/embed/json-formatter?theme=dark&lang=en"
  width="100%"
  height="500"
  frameborder="0"
  loading="lazy"
  title="JSON Formatter"
></iframe>

Embed Features

• ✓Full tool functionality — users can input, process, copy, and download results directly within the iframe
• ✓20-language localization via the ?lang= parameter — match your audience's language automatically
• ✓Light and dark theme support via ?theme= — seamlessly blend with your site's design

Customization Options

• Theme — append ?theme=dark for dark mode or omit for the default light theme. The widget inherits clean, minimal styling that works with most site designs.
• Language — append ?lang=[locale] to render the widget in any of the 20 supported languages (en, tr, es, fr, de, pt, it, nl, ru, ja, ko, zh, ar, hi, pl, uk, sv, id, vi, cs). Defaults to English.
• Size — set width and height on the iframe element using standard HTML attributes or CSS. The widget is responsive and adapts to the container width automatically.

Content Security Policy & Security

All embed widgets use strict Content Security Policy headers with frame-ancestors configured for cross-origin embedding. Data processing happens entirely in the visitor's browser — no user data is transmitted to Akousa servers. The embed is served over HTTPS with the same security standards as the main platform. Your visitors' data stays on their device.

Anonymous Analytics

Embedded widgets track anonymous view counts via Redis to help you understand usage patterns. No personally identifiable information is collected from your visitors. The analytics are lightweight and do not affect widget performance or load time.

ISR & Performance Optimization

Embed pages use Incremental Static Regeneration (ISR) for fast initial loads — pages are statically generated and revalidated periodically. The iframe loads asynchronously and does not block your page's rendering. Combined with lazy loading (loading="lazy"), embedded widgets have near-zero impact on your site's Core Web Vitals scores.

Speakable Structured Data

Each embed page includes Speakable schema markup, making widget content eligible for voice assistant read-aloud. This improves accessibility for visually impaired users and positions your embedded tools for voice search discovery.

Frequently Asked Questions

What tools can be embedded?

All 522 tools are available for embedding using the /embed/[tool-slug] URL format. This includes developer tools, text processors, file converters, and data generators. Each embedded tool is fully functional — users can input data, process it, and copy or download results directly within the iframe on your site.

Is embedding free?

Yes, embedding is completely free with no usage limits, no attribution requirements, and no API keys needed. You can embed as many tools as you want on as many pages as you need. There are no rate limits on embedded widget usage — your visitors can use them without restrictions.

Can I customize the appearance?

Yes! Use URL parameters to customize: ?theme=dark for dark mode (default is light), ?lang=[locale] for any of the 20 supported languages (e.g., ?lang=ja for Japanese). The widget automatically adapts to the container width. You can also set the iframe's width, height, and border styling using standard HTML/CSS attributes on the iframe element.

Is the embedded content secure?

Yes. Embedded widgets use a strict Content Security Policy (CSP) with frame-ancestors configured to allow cross-origin embedding. All data processing happens in the visitor's browser — no user data is transmitted to our servers. The embed uses HTTPS and follows the same security standards as the main akousa.net platform.

Will embedded tools slow down my website?

Embedded tools load asynchronously within the iframe and do not block your page rendering or affect your site's performance. The iframe loads independently, so even if the widget takes a moment to initialize, your page content appears instantly. The widget code is optimized and cached for fast loading via ISR (Incremental Static Regeneration).

Do I need to attribute Akousa when embedding?

No attribution is required. You can embed any tool on your site without crediting Akousa. The widget itself does not display any mandatory branding or links back to the platform.

Can I embed tools on a commercial website?

Yes, embedding is permitted on commercial, non-commercial, personal, and educational websites alike. There are no licensing restrictions or fees for embedding Akousa tools.

How do I set the widget to match my site's language?

Append the ?lang= parameter to the embed URL with any of the 20 supported locale codes. For example, ?lang=ja renders the widget in Japanese, ?lang=de for German. If omitted, the widget defaults to English.

Can I embed multiple tools on the same page?

Yes, you can embed as many tools as you want on a single page. Each iframe operates independently. For performance, consider using loading="lazy" on iframes that are below the fold so they load only when the user scrolls to them.

What happens if Akousa adds new features to a tool I embedded?

Embedded tools automatically receive updates when the platform is deployed. New features, bug fixes, and UI improvements are reflected in your embed without any action on your part. The embed URL is stable and never breaks.

Related Documentation

• Tools Documentation

  Complete guide to using 522 free online tools. Learn about developer tools, text processors, file converters, and data generators — all running securely in your browser with zero signup, zero uploads, and unlimited usage.

• Developer API Reference

  Complete documentation for the akousa.net REST API with 77 endpoints across 16 groups. Integrate tools, games, price data, news, website analysis, and service status into your applications with a well-documented JSON API and OpenAPI 3.1 spec.

• Embed Gallery

  The Embed Gallery at /embed-gallery is a dedicated landing page for webmasters. Browse all 522 embeddable tools, preview how each looks as a widget, check recommended dimensions, and copy the ready-to-use iframe code with one click.

• PDF Suite Documentation

  Guide to 56 free PDF tools covering merging, splitting, compressing, converting, editing, protecting, and AI-powered analysis — all processing in your browser with zero uploads, zero registration, and complete privacy.