Fast installation
Copy the widget code, paste it into a CMS, landing page, or corporate site, and publish without complex development.
Publishing
Embeddable widget for locators
Bring the same public locator into any page on your website with a simple embed code.
Copy-and-paste embed code
Width and height in %, px, or combinations
Same public locator theme and layout
Works on brand, product, and partner pages
Choose width and height in percentages or pixels, copy the code, and embed the locator on any page.
The widget keeps the public page theme, panels, features, and layout for visual and operational consistency.
Overview
Embed the locator where the customer journey already happens
The embeddable widget lets teams display the ShopMaply locator inside existing pages without rebuilding maps, filters, or cards. Administrators generate an embed code and choose dimensions for the available space while keeping the public locator experience.
Consistent branding
The widget inherits theme, colors, pins, panels, filters, results, details, and layout from the public locator page.
Flexible sizing
Use full width, page percentages, fixed height, or pixel dimensions to fit short pages, wide sections, and side areas.
Less maintenance
Theme, entries, features, and content stay centralized in ShopMaply and appear in the widget without duplicated work.
Customization options
Control the space without breaking the locator experience
Widget customization focuses on fitting the host page. The visual and functional experience comes from the public locator to keep consistency.
Dimensions
- Width as a percentage of the page, such as 100% or 80%
- Fixed pixel width, such as 960px or 1200px
- Pixel height for sections with a controlled viewport
- Percentage height when the host container already defines space
- Fluid width with fixed height for landing pages
Inherited experience
- Same published visual-editor theme
- Same search, filters, map, results, and details panels
- Same custom pins and promoted pins
- Same desktop and mobile layout rules
- Same features enabled on the public locator, including AI when available
Compatibility
- Iframe-based embed code
- Works in CMSs, static pages, landing pages, and owned sites
- Visual isolation to avoid conflicts with host-page CSS
- Responsive behavior when percentage dimensions are used
- Public locator URL remains available for direct sharing
Publishing and control
- Code can be regenerated when dimensions change
- Theme changes happen in the visual editor, not the host site
- Published entries appear in the widget after locator updates
- Teams can use different widgets on brand, product, or regional pages
Layout behavior
The widget respects the same public product inside the chosen space
Instead of creating a parallel version, the widget displays the already-approved public experience. That reduces visual risk and keeps one source of truth for layout, content, and features.
Desktop
- Wide layouts can show map, filters, results, and details together
- Narrow widgets benefit from list-first or map-first layouts
- Taller embeds reduce internal scrolling for dense directories
- Percentage width follows grids and containers on the host site
Mobile
- The locator uses the mobile rules already configured in the theme
- Panels keep order and visibility defined in the visual editor
- Fluid dimensions help the widget fill the screen width
- Search, filters, details, and actions stay touch-friendly
Governance
- Marketing controls where the widget appears without changing the data model
- Operations updates locations once and reflects them across all embeds
- Product keeps consistency between the public page and embedded pages
- Teams can test sizing per page without duplicating visual settings
How to generate it
Generate widget code in five steps
The workflow is designed for administrators who need to publish quickly on an existing page without losing brand control.
Open the locator
In the admin panel, select the locator you want to embed and confirm that public data and theme are published.
Open Embeddable widget
Go to the publishing or embed area and choose to generate widget code for the locator.
Set width and height
Choose percentage values, fixed pixels, or a combination. Use 100% width for responsive sections and fixed height when you want to control the visible area.
Copy the code
ShopMaply generates a ready snippet with public URL, dimensions, and embed attributes. Copy the code without manually changing the theme.
Paste, test, and publish
Add the snippet to your CMS or site, test on desktop and mobile, then publish. Future theme and content changes stay in ShopMaply.
Use cases
A widget for product, brand, regional, and campaign pages
Small companies can embed one locator. Larger operations can use widgets across multiple pages to bring search, maps, and conversion closer to customer context.
Product pages
Show where to buy or pick up a specific product without sending visitors away from the commercial page.
Franchise and network sites
Add branch search to institutional, regional, or expansion pages with consistent visual presentation.
Partner portals
Let partners embed the official locator on their sites while data and branding remain centralized.
Campaigns and landing pages
Add maps and results to temporary pages for launches, events, promotions, or priority regions.
Keep exploring
Related features
Visual theme editor
Configure the theme, panels, and layout the widget will inherit.
Learn more →Static maps
Use static exports when you need to reduce dependency on external calls.
Learn more →