Use Settings > Widgets to copy a PawPlacer widget into a website you control. Your organization's public profile must be visible, and the destination site must allow custom HTML and JavaScript.
Choose a Widget
The page has one widget picker with seven choices:
- Full Profile
- Pets
- Foster Form
- Adopter Form
- Volunteer Form
- Surrender Form
- Donor Form
Selecting a widget updates the real desktop or mobile preview, configuration controls, and copyable code. You can also open the preview in a new tab.
Every widget uses PawPlacer's public-page shell and attribution. It exposes only public content.
Configure and Copy
Each snippet mounts into a container ID. Keep the generated ID, or change it when that ID is already used on your page. Copy the generated container, script, and initialization call together.
The Pets widget also supports:
- Pets per page
- Species
- Sort field and direction
The Full Profile widget includes a complete standalone HTML example in addition to the normal snippet.
Add It to a Website
Paste the generated code where the widget should appear:
- In a Custom HTML block for WordPress
- In an HTML-capable page or section for Shopify and other site builders
- Inside the
<body>of a custom site
The script creates a responsive iframe and adjusts its height as visitors navigate or submit forms. Avoid CSS that forces a fixed iframe height.
Visibility and Forms
The preview indicates whether the selected widget currently has public content. The full profile reflects the same organization information, pets, forms, and available public sections as the direct public page. A focused component shows only that selected public surface.
Embedded forms use the active public form templates and submission behavior. If the template has a safe post-submission redirect, the embed follows it after a successful submission.
Form widgets always use the default template for their record type. A non-default template cannot be selected in widget settings and does not have separate embed code. Preview it in Settings > Forms, then make it the default when it is ready for public use.
Adopter, foster, volunteer, and donor widgets also follow their matching public-feature setting. The surrender widget has no separate public-feature switch and is available whenever the profile is public and a default surrender template exists.
The organization ID in a widget is public and fixed. It identifies which public content to load; it does not grant access to internal data. Never add an API key to widget code.
Troubleshooting
- Nothing renders: Confirm the public profile is visible, the organization ID is unchanged, and the destination permits external scripts and iframes.
- No pets appear: Confirm the organization allows public pets and that individual pets meet the public-visibility requirements.
- A form is unavailable: Confirm a default template exists and the matching public feature is enabled. Surrender depends on profile visibility rather than a separate switch.
- The wrong questions appear: The widget uses the default template. Confirm the intended template has the Default badge in Settings > Forms.
- The frame is clipped: Remove fixed iframe height or overflow rules from the host page.
- Your site builder removes the script: Use a custom-code or HTML-embed area that permits JavaScript. A plain rich-text block cannot run the widget.
- An update is not immediate: Reload the host page. If the host uses page caching, publish or clear that page's cache; the public content itself is loaded from PawPlacer.
Widgets include public-page analytics and use the same validation and rate limits as direct public pages.