--- title: URL Entries description: "The **URL Price Entries** section is the core of PriceFetchWP. This is where you define the external websites PriceFetchWP should recognize and how prices should be retrieved from those sources. For normal website fetching, each URL Entry connects an external…" url: "https://pricefetchwp.com/documentation/url-entries/" updated: "2026-09-09" category: Core Configuration --- # URL Entries The **URL Price Entries** section is the core of PriceFetchWP. This is where you define the external websites PriceFetchWP should recognize and how prices should be retrieved from those sources. For normal website fetching, each URL Entry connects an external domain with one or more selectors used to locate the Regular Price and/or Sale Price. A URL Entry can also be configured to use a supported Affiliate API or Proxy provider through **[Advanced Options](https://pricefetchwp.com/documentation/advanced-options/)**. Once an entry is configured, PriceFetchWP can use it dynamically across your site whenever a matching external URL is encountered. 1. [– How URL Entries Work](#how-url-entries-work) 2. [- How URL Entries Work for WooCommerce](#how-url-entries-work-for-woocommerce) 3. [- How URL Entries Work for Pages and Posts](#how-url-entries-work-for-pages-and-posts) 4. [– Why URL Entries Are Needed](#why-url-entries-are-needed) 5. [– Adding a URL Entry](#adding-a-url-entry) 6. [– Domain](#domain) 7. [– Sale Price Selector](#sale-price-selector) 8. [– Regular Price Selector](#regular-price-selector) 9. [– Selector Type](#selector-type) 1. [XPath](#xpath) 2. [ID](#id) 3. [Class](#class) 4. [Script](#script) 10. [– Also Check Selectors](#also-check-selectors) 11. [– Reverse Order](#reverse-order) 12. [– Test Entry](#test-entry) 13. [– Advanced Options](#advanced-options) 14. [– Affiliate Entries](#affiliate-entries) 15. [– Proxy Entries](#proxy-entries) 16. [– Affiliate / Proxy Status Indicator](#affiliate-proxy-status-indicator) 17. [– Pause Entry](#pause-entry) 18. [– Price Cache](#price-cache) 19. [– Quick Save](#quick-save) 20. [– Reordering URL Entries](#reordering-url-entries) 21. [– Adding Multiple URL Entries](#adding-multiple-url-entries) 22. [– Example Setup](#example-setup) 1. [Domain](#domain-2) 2. [Sale Price Selector](#sale-price-selector-2) 3. [Sale Price Type](#sale-price-type) 4. [Regular Price Selector](#regular-price-selector-2) 5. [Regular Price Type](#regular-price-type) 23. [⚠️ Common Issues](#eb-table-content-31) 1. [The exact product URL does not match my URL Entry](#the-exact-product-url-does-not-match-my-url-entry) 2. [No price is found](#no-price-is-found) 3. [The price works on some products but not others](#the-price-works-on-some-products-but-not-others) 4. [The external website cannot be fetched](#the-external-website-cannot-be-fetched) 5. [An Affiliate provider cannot be selected](#an-affiliate-provider-cannot-be-selected) 24. [– Recommended URL Entry Workflow](#recommended-url-entry-workflow) 25. [Next Steps ───](#eb-table-content-38) ## – How URL Entries Work A URL Entry acts as the configuration PriceFetchWP uses for a particular external website. For example: ``` example.com ``` might have: ``` Sale Price Selector: .product-sale-price Regular Price Selector: .product-regular-price ``` When PriceFetchWP encounters an external URL such as: ``` https://example.com/products/example-product ``` it recognizes the domain and uses the matching URL Entry configuration. The exact product/page URL can be different each time. You normally only need one URL Entry for a website unless a special integration requires otherwise. --- ## - How URL Entries Work for WooCommerce For WooCommerce External/Affiliate products, the general process is: 1. The WooCommerce product is processed. 2. PriceFetchWP checks for the configured WooCommerce custom field. 3. The external product URL is read from the custom field value. 4. The external URL domain is matched to a PriceFetchWP URL Entry. 5. PriceFetchWP checks whether a valid cached price is available. 6. If a new fetch is needed, the matching URL Entry configuration is used. 7. PriceFetchWP retrieves the Regular Price and/or Sale Price. 8. The WooCommerce product price is updated according to your settings. 9. The fetched price can be cached for the configured amount of time. Using the default WooCommerce configuration, the custom field name is: ``` external_price_fetch ``` The custom field value should contain the full original external product URL. See: **[WooCommerce Settings](https://pricefetchwp.com/documentation/woocommerce-settings/)** for complete WooCommerce configuration information. --- ## - How URL Entries Work for Pages and Posts For Page/Post price output, the general process is: 1. The page or post loads. 2. PriceFetchWP detects the configured shortcode. 3. The shortcode contains the external product/page URL. 4. PriceFetchWP matches that URL to a configured URL Entry. 5. A cached price is used when available. 6. If a new fetch is required, the matching URL Entry configuration is used. 7. PriceFetchWP displays the retrieved price according to your Page/Post settings. This allows one URL Entry to support many different product URLs from the same external website. --- ## – Why URL Entries Are Needed Different websites use different HTML structures and different ways of storing prices. URL Entries allow you to: - Connect multiple external price sources - Configure different selectors for each website - Retrieve both Sale Price and Regular Price values - Add fallback selectors for different page layouts - Configure caching per external source - Pause individual price sources - Use supported Affiliate APIs - Route difficult websites through supported Proxy providers - Apply request settings only where needed This gives you control over how each external price source is handled without requiring one global configuration for every website. --- ## – Adding a URL Entry Go to: **WordPress Dashboard → PriceFetchWP → URL Price Entries** Click: **Add New Entry +** A new URL Entry will be added to the list. Each entry is numbered so you can easily identify it while configuring or testing your sources. The entry number is only used to help organize the settings. --- ## – Domain Enter the domain PriceFetchWP should recognize. For example: ``` example.com ``` You do not normally need to enter a complete product URL here. The individual product/page URL is provided later through your Page/Post shortcode or WooCommerce custom field. For example, this product URL: ``` https://www.example.com/products/example-product ``` can match a URL Entry configured for: ``` example.com ``` PriceFetchWP validates the actual hostname when matching external URLs. --- ## – Sale Price Selector The **[Sale Price Selector](https://pricefetchwp.com/documentation/sale-price/)** tells PriceFetchWP where to look for the current/sale price. For example: ``` .product-sale-price ``` or an XPath such as: ``` //span[@class='sale-price'] ``` A Sale Price selector is optional. If you only need a Regular Price, you can leave the Sale Price selector empty. --- ## – Regular Price Selector The **[Regular Price Selector](https://pricefetchwp.com/documentation/regular-price/)** tells PriceFetchWP where to look for the normal or comparison price. For example: ``` .product-regular-price ``` or: ``` //s[@class='compare-price'] ``` The Regular Price selector is also optional. You may configure: - Sale Price only - Regular Price only - Both Sale Price and Regular Price depending on the external website and how you want prices displayed. --- ## – Selector Type Each price selector must have a selector type. PriceFetchWP currently supports: - **XPath** - **ID** - **Class** - **Script** Choose the type that matches the selector you entered. For example: ### XPath ``` //span[@class='price'] ``` ### ID ``` product-price ``` ### Class ``` product-price ``` ### Script ``` #viewed_product::Price ``` Script selectors can retrieve compatible price values stored inside script data already present in the fetched HTML. Script selectors do **not** execute JavaScript. See: **[Finding Price Selectors](https://pricefetchwp.com/documentation/finding-price-selectors/)** for more information. --- ## – Also Check Selectors Some websites use more than one product-page layout. For example, one product might use: ``` product-price ``` while another product on the same website uses: ``` current-price ``` Use: **[Also check (Secondary Selectors)](https://pricefetchwp.com/documentation/also-check/)** to add fallback selector rows. PriceFetchWP processes the configured selector rows in order until it finds a usable price. Each Also Check row can contain its own: - Sale Price Selector - Sale Price Selector Type - Regular Price Selector - Regular Price Selector Type This allows a single URL Entry to support several variations of the same external website. You can configure multiple selector rows when needed. --- ## – Reverse Order Some websites place two prices inside the same selector. For example: ``` $4.99 $9.99 ``` or: ``` $9.99 $4.99 ``` PriceFetchWP includes price-order controls to help interpret these layouts. **Reverse order** is only available when the applicable: **WooCommerce style** price format is selected. If WooCommerce style is not selected, Reverse order is disabled. See: **[Reverse Price Logic](https://pricefetchwp.com/documentation/reverse-price-logic/)** for examples and configuration information. --- ## – Test Entry Every URL Entry includes: **[Test Entry](https://pricefetchwp.com/documentation/test-entry/)** We strongly recommend using Test Entry before putting a URL Entry into use. Test Entry allows you to enter an exact product/page URL and verify: - Whether the source can be reached - Whether a price was found - Sale Price and Regular Price results - Which selector row matched - Which selector type matched - Direct, Proxy, or Affiliate fetch mode - HTTP status - Request timing - Proxy cost when available - Raw HTML returned by the source You can also change selectors or Advanced Options and test them **before saving the URL Entry**. See: **[Testing a URL Entry](https://pricefetchwp.com/documentation/testing-a-url-entry/)** for complete information. --- ## – Advanced Options Each URL Entry has its own: **[Advanced Options](https://pricefetchwp.com/documentation/advanced-options/)** These settings allow you to customize how that specific external source is handled. Depending on your configuration, Advanced Options may include settings for: - Price Cache - Request timeout - User-Agent - Referer Header - SSL Verification - Affiliate Integration - Proxy Integration - Other request behavior You normally do not need to change every Advanced Option. Only use the settings required by that particular external website. --- ## – Affiliate Entries A URL Entry can use a supported Affiliate API instead of normal website selectors. Open: **Advanced Options** and enable: **Use affiliate** Then select a configured Affiliate provider. When Affiliate mode is active: - The Affiliate API becomes the price source - Normal selector controls are disabled - The applicable Affiliate domain is locked - Proxy mode cannot be used on the same entry - An **Affiliate** indicator appears beside the entry number Each Affiliate provider can only be assigned to one URL Entry at a time. For example: ``` Amazon — in use (Entry 1) ``` may appear if Amazon is already assigned elsewhere. See: **[Affiliate Integration](https://pricefetchwp.com/documentation/affiliate-integration/)** for full setup instructions. --- ## – Proxy Entries A URL Entry can optionally use one of PriceFetchWP’s supported Proxy providers when a normal Direct Fetch is not sufficient. When Proxy mode is active, an indicator such as: ``` Proxy: Scrapfly ``` or: ``` Proxy: PhantomJSCloud ``` appears beside the entry number. Proxy settings are configured under: **[Advanced Options](https://pricefetchwp.com/documentation/advanced-options/)** Affiliate and Proxy modes cannot be enabled on the same URL Entry. See: **[Proxy Integration](https://pricefetchwp.com/documentation/proxy-integration/)** for additional information. --- ## – Affiliate / Proxy Status Indicator PriceFetchWP displays a small status indicator beside the URL Entry number when an entry uses a special fetch mode. Examples: ``` 1 Affiliate ``` ``` 2 Proxy: Scrapfly ``` ``` 3 Proxy: PhantomJSCloud ``` If the URL Entry uses a normal Direct Fetch, no special status indicator is displayed. This allows you to quickly identify Affiliate and Proxy entries without opening Advanced Options. --- ## – Pause Entry Individual URL Entries can be paused. When an entry is paused, PriceFetchWP temporarily stops using that URL Entry for normal price retrieval. This can be useful when: - An external website is temporarily unavailable - You are troubleshooting an entry - A selector needs to be updated - You temporarily do not want requests sent to that source Pausing an entry allows you to keep its configuration without deleting it. Resume the entry when you are ready to use it again. --- ## – Price Cache PriceFetchWP supports global price caching, but each URL Entry can also have its own cache timing through Advanced Options. This is useful when different external sources need different refresh schedules. For example: ``` Website A → refresh every 4 hours Website B → refresh every 12 hours ``` If no custom cache value is configured for the URL Entry, the global Price Cache setting is used. See: **[Price Cache](https://pricefetchwp.com/documentation/price-cache/)** for more information. --- ## – Quick Save Use: **Quick Save** to save your PriceFetchWP settings without refreshing the page. This is especially useful while working with URL Entries because you can make changes, save them quickly, and continue configuring the page. You can also use the main: **Save Changes** button. --- ## – Reordering URL Entries URL Entries can be organized within the PriceFetchWP settings page. The entry numbers update to reflect their current order. Reordering entries is primarily an organizational feature and helps keep large collections of external price sources easier to manage. --- ## – Adding Multiple URL Entries Click: **Add New Entry +** whenever you need to configure another external website. You can create URL Entries for many different external sources. For example: ``` Entry 1 → example-store.com Entry 2 → another-store.com Entry 3 → retailer-example.com ``` Each entry can have its own: - Selectors - Selector types - Also check selectors - Cache timing - Advanced request settings - Proxy configuration - Affiliate configuration where supported --- ## – Example Setup A normal URL Entry might look like: ### Domain ``` example-store.com ``` ### Sale Price Selector ``` sale-price ``` ### Sale Price Type ``` Class ``` ### Regular Price Selector ``` regular-price ``` ### Regular Price Type ``` Class ``` A product URL such as: ``` https://example-store.com/products/example-product ``` would then use this URL Entry. Before using it on your site, click: **Test Entry** and verify the correct prices are returned. --- ## ⚠️ Common Issues ### The exact product URL does not match my URL Entry Make sure the URL Entry contains the correct external domain. For example: ``` example.com ``` should be used for product URLs from that website. Use **Test Entry** with the exact product/page URL to verify that PriceFetchWP recognizes the source. ### No price is found Run **Test Entry**. If the page is successfully fetched but the price is not found, check: - Selector value - Selector type - Sale Price vs. Regular Price configuration - Also check selectors - Raw HTML See: **[Finding Price Selectors](https://pricefetchwp.com/documentation/finding-price-selectors/)** ### The price works on some products but not others The external website may use more than one page layout. Use: **[Also check](https://pricefetchwp.com/documentation/also-check/)** to configure additional fallback selectors. Test several product URLs from the same domain. ### The external website cannot be fetched Check the HTTP status and Test Entry result. The website may: - Block server-based requests - Rate limit requests - Require a Proxy provider - Return different content than your browser receives See: **[Blocked Requests](https://pricefetchwp.com/documentation/blocked-requests/)** and **[Proxy Integration](https://pricefetchwp.com/documentation/proxy-integration/)** ### An Affiliate provider cannot be selected Check: **[Affiliate Integration](https://pricefetchwp.com/documentation/affiliate-integration/)** The provider must be configured before it becomes available. Also make sure it is not already assigned to another URL Entry. Each Affiliate provider can only be used by one URL Entry at a time. --- ## – Recommended URL Entry Workflow When adding a new external source: 1. Click **Add New Entry +** 2. Enter the external domain 3. Configure the Sale Price and/or Regular Price selector 4. Select the correct selector type 5. Add **Also check** selectors if needed 6. Open **Advanced Options** if the source requires special handling 7. Click **Test Entry** 8. Enter an exact product URL 9. Confirm the expected price is found 10. Test several products from the same website 11. Click **Quick Save** or **Save Changes** Testing several products before considering an entry complete is strongly recommended. --- ## Next Steps ─── For more information, continue with: - **[Finding Price Selectors](https://pricefetchwp.com/documentation/finding-price-selectors/)** - **[Also Check (Fallback Selectors)](https://pricefetchwp.com/documentation/also-check/)** - **[Testing a URL Entry](https://pricefetchwp.com/documentation/testing-a-url-entry/)** - **[Advanced Options (Per URL Entry)](https://pricefetchwp.com/documentation/advanced-options/)** - **[Reverse Price Logic](https://pricefetchwp.com/documentation/reverse-price-logic/)** - **[Price Cache](https://pricefetchwp.com/documentation/price-cache/)** - **[Affiliate Integration](https://pricefetchwp.com/documentation/affiliate-integration/)** - **[Proxy Integration](https://pricefetchwp.com/documentation/proxy-integration/)** - **[Blocked Requests](https://pricefetchwp.com/documentation/blocked-requests/)**