Documentation index

Developers and API ›

Adding iubenda to your site (direct text embedding and API)


The direct text embedding option is the one option that makes your privacy policy look as if it were part of your own site. On mobile apps the policy displays both the simplified version (on top) and the legal version (below) per default. We offer multiple ways for embedding a privacy policy into the body of one of your pages. You can use javascript or call our API from your backend. There are four options:
  • Styled privacy policy
    • Embed via javascript
    • Embed via API from your backend
  • Clean HTML privacy policy with no styles
    • Embed via javascript
    • Embed via API from your backend
embedding_options

Click here for a direct text embedding example (with style)

Here's an example of what the "Direct text embedding" looks like on a website. Note that should you choose the "legal only" option - the summary section of the policy won't be displayed. For illustration purposes we've pasted the embedding code below. Click on the "Direct embedding with style" for it to reveal the whole policy. As you can see, it adapts to your page in terms of typeface and size, and if you are an HTML/CSS expert you can always tweak the result by adding your custom CSS definitions to the classes used in the code.

Direct embedding with style

Privacy Policy

Click here for a direct text embedding example (with no style)

By enabling the "Use plain HTML with no styling", the policy will be displayed with no predefined styles. Notice that this version comes only in the legal version by default (no summary section with icons).

Direct embedding with no style

Privacy Policy

API Documentation

The following API URLs are available:
www.iubenda.com/api/privacy-policy/:public_id www.iubenda.com/api/privacy-policy/:public_id/only-legal www.iubenda.com/api/privacy-policy/:public_id/no-markup
:public_id is the ID of your privacy policy provided by your privacy policy embedding options. The response type is application/json and all the URLs are available in both http and https. Example: curl --include --request GET 'http://www.iubenda.com/api/privacy-policy/:public_id' Response: - Everything OK, response status 200: { :success     => true, :content     => “… privacy policy content …" } - Required privacy policy is not found, response status 404: { :success      => false, :error        => "Privacy Policy not found." } - Required privacy policy is not Pro, response status 403: { :success      => false, :error        => "To access this privacy policy via API, convert it to Pro." } - Application error, response status 500: { :success     => false, :error       => “Application Error. Please contact info@iubenda.com for support." }

Other embedding options

The above are the options to embed the privacy policy into a page on your site. If you don't need that amount of control, you can still use the button that will open up a modal window or a direct link. embedding_options_links

Watch the video on the integration options instead


Still have questions?

Visit our support forum Email us