Home › Docs › Addons › Stock Images
Stock Images
$5 Search commercial-friendly stock providers and import images safely.
Every purchase is a single signed, install-ready ZIP that also includes full TypeScript/Vue source, sourcemaps, and build tooling (npm ci && npm run build) if you want to customize it yourself. Installs and updates through the in-app addon marketplace.
What Stock Images does
Stock Images adds a Stock panel (“Browse licensed photos”) to the Veyo product designer. It is backed by Openverse (no API key required; searches ask for commercially licensed images) and Pixabay (using your own API key). By default shoppers browse only the images you have imported into My library; you can optionally let them search the providers live.
Your Pixabay API key stays server-side and is never exposed to the browser, so customers can search and import stock images without any risk of your key leaking.
How to enable Stock Images
-
Buy the addon
Your Polar purchase email (and the Polar customer portal) contains the addon ZIP.
-
Upload it in the Veyo Apps screen
Open Veyo → Extensions and upload the ZIP. Veyo verifies the package and installs it.
-
Enable it
Toggle Stock Images on. Openverse works immediately; to enable Pixabay, add your Pixabay API key under Library → Stock Images → Settings (see below).
How to use Stock Images
-
Open the Stock Images panel
Shoppers open the Stock panel in the designer (in the images group). By default it lists and searches the images you imported; with Live provider search on, it searches Openverse or Pixabay directly.
-
Pick a commercially licensed image
Click a result to see its attribution and license (with a link to the license and to the original source) before adding it. Openverse searches request commercially licensed images; Pixabay images carry the Pixabay Content License. The merchant remains responsible for checking that each image suits the intended use.
-
Import it as a layer
Click Add to design. The image is copied to your server and dropped at the centre of the print area like any uploaded image, ready to move and resize.
At a glance
| Version | 1.0.7 |
|---|---|
| Platforms | WordPress + WooCommerce, OpenCart 3 & 4, PrestaShop 8 & 9, and Shopware 6.6 / 6.7. Since 1.0.4 with Veyo 1.6.1, OpenCart and PrestaShop run the same build as WordPress, Pixabay included. |
| Requires | Veyo Product Personalizer 1.1.0 or later. No other addon is required. |
| Where settings live | Veyo Personalizer → Library → Stock Images, with the tabs Find & import, My library and Settings. See the Admin guide. |
| Server tools / outside services | No extra server tools. The server contacts Openverse (api.openverse.org, with api.openverse.engineering as a fallback) and, if enabled, Pixabay (pixabay.com). Pixabay needs your own free API key. |
What shoppers see
- A Stock panel in the designer's left panel (“Browse licensed photos”) with a Search photos box, a results grid and Load more.
- Library only (default): the panel lists the images you imported and searches within them (title, file name, attribution, license and source address). If you have imported nothing, it says “No curated stock images are available yet.”
- Live provider search: the panel searches Openverse or Pixabay directly, 16 results per page, and shows only providers that are ready.
- Clicking a result opens a preview with Attribution, License (linked to the license text) and Open original source, then Add to design.
- If Pixabay's rate limit is reached the panel shows “Pixabay rate limit reached. Retry in N s.” and a Retry Pixabay button once the wait is over.
Settings
Open Library → Stock Images → Settings and click Save in the bar that appears when you have unsaved changes (or Discard).
| Setting | Default | Range / options | What it does |
|---|---|---|---|
| What can shoppers search? | Library only | Library only (recommended) or Live provider search | Library only lets shoppers use just the images you imported (safest and fastest). Live provider search also lets them search Openverse and Pixabay directly and uses the providers' rate limits. |
| Openverse | On | On / off | Commercial-license filtered search. Needs no key. |
| Pixabay | On, but inactive until a key is saved | On / off | Shows Key required until an API key is saved, then Ready. |
| Pixabay API key | Empty | Text, write-only | Type a key to save or replace it. A saved key is never shown back; the field says a key is saved. Tick Clear saved Pixabay key to remove it. A link to get a free key is next to the field. |
The page also shows the notice “You are responsible for image licenses”: provider metadata helps shoppers understand attribution and licensing, but you must check that each image is suitable for its use.
Find & import is where you search as an admin and click Import (or Import to library in the preview). Imported images show In library and appear in My library, which you can search and filter by provider. Remove from library only hides the image from shoppers; designs that already use it keep working.
What you get in orders and production
- An ordinary image layer. The imported file is saved on your server and used like any uploaded image, so it goes into the production files with the rest of the design (see Orders & production).
- Source details on the layer. Each layer keeps the provider, attribution, license name, license link and source link, so you can look up where an image came from. The addon does not print attribution onto the product.
- Import limits. The server downloads from public web addresses only, up to 15 MB, and accepts JPEG, PNG and WebP. Other types, oversized pixel dimensions or invalid files are refused.
Data and privacy
- Outside requests: only the server calls the providers, and only for searches and imports. Searches send the search words (and, for Pixabay, your API key) to the provider. Shoppers' browsers never talk to Openverse or Pixabay for data, and never receive your key.
- Stored on WordPress: options
veyop_stock_images_settings(including your Pixabay key, encrypted when saved and kept as plain text only if libsodium or a site secret is missing),veyop_stock_images_library_index(up to 1000 recent imports), oneveyop_stock_import_*record per imported image, and cached search results (6 hours for Openverse, 24 hours for Pixabay, plus a stale copy kept up to 7 days that is shown if a provider fails). - Files: imported images are saved in Veyo's upload folder under
uploaded/upload/YYYY/MM/, namedstock-<provider>-…, with thumbnails and medium copies. - Shopper data: none is stored by the addon. Search and import calls are each limited to 30 per 60 seconds.
- Uninstalling the addon keeps all of this, so reinstalling restores your library. Uninstalling the whole of Veyo with Keep data when uninstalling off deletes every
veyop_*option and Veyo's upload folder, including these. See Uninstalling & your data.
Troubleshooting
- The Stock panel shows “No curated stock images are available yet.” Library only is the default. Import images in Find & import, or switch to Live provider search in Settings.
- “No provider is available. Enable Openverse or add a Pixabay key in Settings.” Both providers are off or Pixabay has no key. Turn Openverse on or save a Pixabay key, then Save.
- “Pixabay rate limit reached.” Pixabay's limit was hit. Searches pause for the time Pixabay asks for (60 seconds if it gives none, at most one hour), and recent cached results are shown meanwhile. Use Openverse or wait, then Retry Pixabay.
- “Direct stock provider search is disabled.” or “Direct stock provider import is disabled.” A shopper tried a live search or imported an image that is not in your library while Library only is on. This is expected; import the image yourself or enable live search.
- “Stock image type is not supported.”, “too large” or “Provider URL failed public-network validation.” The image is not a JPEG/PNG/WebP under 15 MB, or the address is not a public one. Pick another image.
FAQ
Is a Pixabay account required?
Only if you want Pixabay results. Openverse works with no key at all. Add a Pixabay API key in Library → Stock Images → Settings to also use Pixabay; until a key is saved, Pixabay shows Key required and is not used.
Is my Pixabay key ever visible to customers?
No — it's stored and used server-side only; the browser never receives it.
Installing, updating and removing
- Install: upload the ZIP in Extensions, then enable it. See Install addons.
- Update: upload the newer ZIP over the old one. Settings and data are kept. See Upgrading.
- Remove: Uninstall on the addon card removes its files and keeps its data, so reinstalling restores everything. See Uninstalling & your data.