Configuration guide for Local SEOOur Local SEO plugin helps you rank in local search results, Google Maps, and the Knowledge panel. This guide helps you configure your Local SEO plugin correctly.
To give your site an ultimate SEO treatment, you need Yoast SEO Premium! For example, its advanced text analysis helps you write naturally flowing texts. The internal linking tool and the content filters make your posts easy to find. 404 errors become a thing of the past with the redirect manager. And the social previews give you full control of how your posts appear on social media. Get Yoast SEO Premium!
Unsure how to properly represent your company? Google has some great guidelines for representing your business in search results.
Want to learn all about Local SEO and improve your rankings in the local search results? Then check out our Local SEO training now!
Related articles
Install the plugin
Required: Google Maps API browser key
Connect the subscription
Optional: Google Maps API server key
Setting Up Location Landing Pages: Things to Consider
Table of contents
Where to find the Local SEO settings
The Local SEO settings
Business info
Maps settings
API key
Submit your Geo Sitemap to search engines
Using the Store Locator
Widgets
Shortcode Buttons (Classic Editor)
Local SEO Gutenberg Blocks
Shortcodes
Shipping method settings
New order statuses
New order statuses mails
The checkout process
Developer Filters
Edit Location Archive Template Files
Use a CSV File to Upload Location Data
Where to find the Local SEO settings
When you』ve installed the Local SEO plugin and you』ve activated it, you can find your Local SEO settings by following these steps:
Log in to your WordPress website. When you』re logged in, you will be in your 『Dashboard』. Click on 『SEO』. On the left-hand side, you will see a menu. In that menu, click on 『SEO』. Click on 『Local SEO』. The 『SEO』 settings will expand providing you additional options. Click on 『Local SEO』.
The Local SEO settings
Once you』ve found the Local SEO settings, it』s time to configure them correctly for your business, so the Local SEO plugin can help you rank better in the local search results.
The Local SEO settings consist of five tabs: Business info, Opening hours, Maps settings, API key, and Advanced settings. We』ll discuss these tabs below.
The Local SEO settings tabs
Business info
In the Business info tab, you can set up the location of your business. This information will be used in the search results and can be used to add blocks with contact information or a map to a page or post on your website.
The number of locations
The first thing you need to do is indicate whether your business has multiple locations, by switching the toggle below.
The Business info settings depend on whether your business has a single location or multiple locations. To continue this configuration guide, please choose between the following options:
My business has a single location
My business has multiple locations
Business Info Details
My business has a single location
If your business only has a single location and you』ve switched the multiple locations toggle to 『no』, you』ll see the settings below.
First, you can set up your company name and logo within the general Search Appearance settings in Yoast SEO, by following the link that』s provided.
Then, you can enter your single location details by filling in the sections. Most of these fields are self-explanatory, like name and address. We』ll discuss some of the other fields below.
My business has multiple locations
If your business has multiple locations, switch the toggle to 『Yes』 and click save. Now, Yoast SEO will automatically create a new Custom Post Type where you can manage your locations.
Setting up a primary location and shared business info
When you switch the multiple locations toggle to Yes, you will see a few additional available options. Firstly, if all you locations are part of the same business, you should switch the toggle to yes. That will reveal the setting for the primary location and the shared business info.
You can set the primary location of your business by choosing the appropriate location from the drop-down menu. Your primary location should be something like your head office, for example. By configuring this setting, you allow the Local SEO plugin to output the correct structured data for your business.
The multiple locations of your business may also have shared business information. For example, you may have the same e-mail address, website, and business type. With Local SEO, you can add shared business information to all locations at once, so you save time, and you give the plugin the correct data.
If most of your business locations share the same information, but there are some that differ, you can also override the shared information for that particular location.
Business info details (single and multiple locations)
Below, we』ll discuss some of the Business info fields. These fields are the same for single and multiple locations.
Business type: enter the business type that best describes your business. If there are no options that best describe your business, we suggest going with 「Local business」. Learn more about different business types.VAT ID/TAX ID/Chamber of Commerce ID: text fields where you can add your company』s IDs, depending on the location of your business.Price range: the price range field has multiple options from $ (cheap) to $$$$$ (expensive). The selection should cover the majority if not all of the products offered by your store or location.Currencies accepted: this field allows you to enter the currencies that are accepted by your company. This is a text field that has no restrictions. The schema documentation recommends using ISO 4217 currency format for best results.Payment methods accepted: this field allows you to enter the payment methods that are accepted by your company. This is a text field that has no restrictions.Area served: this field allows you to enter the geographic area where a service or offered item is provided. This is a text field that has no restrictions. If you enter multiple areas, use a comma to separate them. For example, 「New York, Seattle」, or, 「Germany, France」.
Location coordinates
Here, you can enter the location coordinates of your business (latitude and longitude). When you enter a Google Maps API key (on the API key tab), these coordinates will be automatically calculated.
Address format
Address formats are different in different countries. These settings allow you to select the right address format for your business.
Adding new locations
As we mentioned earlier, when you select multiple locations, the plugin creates a new custom post type that you can use to add new locations. You can find the custom post type in the menu on the left-hand side under the 『Locations』 menu item. To add a new location, click 『New Location』 and enter the details for the location. This will serve as a landing page for the individual location.
You can customize the page with information about your location. There are shortcodes available for your convenience, for the address, map, opening hours and store locator.
By clicking the arrow in the lower right corner (indicated by the pink arrow in the image above), you』ll open the Yoast Local SEO settings. These settings consist of the following tabs: Business info, Opening hours, and Map settings.
Opening hours
The next tab (both for single and multiple locations) is the opening hours tab.
Opening hours for a single locationOpening hours for multiple locations
Opening hours for a single location
For a single location, you can find the opening hours settings in the Local SEO settings. Here, you can indicate whether you want to show or hide the opening hours option. If you choose to show this option, you can enter a custom text to display in the store locator for locations that are closed or open for 24 hours.
You can also indicate whether you want to use the 24h format, whether your business is open 24/7 and whether you have two sets of opening hours per day. Finally, you can enter the opening hours per day.
Location settings for single locations
Opening hours for multiple locations
If your multiple locations have shared opening hours, you can fill in those hours in the Opening Hours tab. To do that, you will need to make sure to toggle the Locations shared opening hours setting to Yes. If the opening hours of some of your locations differ, you can override the shared opening hours settings by editing the opening hours in the Location post type for that location.
Suppose all your locations have different opening hours. In that case, you can switch the Locations shared opening hours toggle to No and set the individual opening hours in the Opening hours tab in the Locations post type. There, it』s possible to indicate whether you want to use the 24h format, whether this location of your business is open 24/7 and whether you have two sets of opening hours per day. Finally, you can enter the opening hours of this location per day.
Maps settings
The next tab shows the Maps settings. To enable these settings, you』ll first have to set an API key.
The Maps settings allow you to make changes in the maps that appear on your site. You can set which measurement system you want to use, what the default map style should be, and you can set a custom marker.
Measurement system: This option is used to output the measurement system when calculating distance. Choose between kilometers and miles.Default map style: This option specifies the default display of the map. Choose between hybrid, satellite, roadmap, or terrain.Custom marker: This option allows a custom map marker to display instead of the default Google map marker. The custom marker should be 100×100 px.
The Store locator settings allow you to change the number of results shown in the store locator, the primary country that should be used, and to set what should be displayed in the 「Show route」 label.
API key
On the next tab, you can enter your Google Maps API key. You need to set this API key to enable the Maps settings of our Local SEO plugin.
If you want to know more about how to create and set your Google Maps API key, you can check the explanation in this article.
Advanced settings
The last tab shows the Advanced settings. This section comes with permalinks settings, admin label settings, and enhanced search settings.
Permalinks settings allow you to enter custom permalink structures for your locations and location categories. Each location and location category will receive a custom URL. By default, these are /locations/%postname%/ and /locations-category/%category-slug%/.
Admin Label settings allow you to change the title of the menu item in your admin sidebar. By default, this menu item is labeled using the plural term of locations, with every single item being called a location. If you like, you may enter custom single and plural labels to better match your business.
Enhanced search settings allow you to include your business locations in the site-wide search results.
Submit your Geo Sitemap to search engines
You don』t have to submit the geo-sitemap to Google Search Console (former Google Webmaster Tools) yourself. The plugin automatically adds it to sitemap_index.xml, so all you have to do is submit sitemap_index.xml to Google Search Console (former Google Webmaster Tools). Which you probably already did! But if you haven』t, please follow the steps here.
Using the Store Locator
The plugin comes with a built-in Store Locator that allows your customers to easily find your store. Check out this article to learn how to set it up; https://yoast.com/help/store-locator/
Widgets
You can view the widgets by going to Appearance->Widgets. These widgets may be used to display to address details or a map (we』re using Google Maps for this).
Show Address Widget
Show Map Widget
Show Opening Hours Widget
Store Locator Form Widget
Note: The location dropdown list will only be visible if you』ve set more than one location.
Show Address Widget
You will need to select a location from the drop-down menu.The map widget allows complete customization. By selecting the boxes you can customize what exactly is displayed. The options listed in the location widget are self-explanatory.
The extra comment section about the bottom may be useful if you have unique information about your business your customers need to know such as parking, gate entrances, or a door buzzing procedure.
Back End
Front End
Show Map Widget
The map widget controls how the map is displayed.
If you have multiple locations Be sure to select a location from the drop-down menu
All Locations By selecting 「Show all Locations」, the map will show all your locations rather than the one specified in the drop-down menu. Map Dimensions The dimensions of the map are controlled by the height and width options Zoom Level Zoom level controls how the map is viewed. 1 is the farthest away and 21 is the closest. Show State, Country, URL Enabling 「Show State, Show Country, and Show URL」 in the info-window provides some additional information for users when they click on the map marker. The default info-window displays the address, city, and zip/post code. Route Planner Enabling Show Route Planner displays a route tool that users can use to help plan their trip
Default Info-Window Settings
Enabling Show State, Show Country, Show URL in info-window
Map Widget with Show Route Planner enabled
Show Openings Hours Widget
This widget shows your opening hours.
If you use multiple locations be sure to select your locationSelect the days you want to showHide Closed Days should be enabled if you had set your opening hours to be closed. If you have this option will not show those daysExtra Comment is useful for displaying extra information about your hours such as extended hours, special hours, closing early etc.
Back End
To set your hours to be closed navigate to the location and change the hours in the drop-down menu
Front End
Widgets with page builders
With some page builders you may be able to embed a Local SEO widget instead of using a shortcode or a button. Consult your page builder』s plugin or theme authors for more information on how to embed a widget.
Local SEO Gutenberg Blocks
With the Gutenberg Editor you can add Local SEO blocks by clicking on the + plus sign and searching for the blocks or scrolling down and clicking on the Yoast Structured Data Block Section. Then Insert the block. You can find the following blocks: Map, Address, Opening Hours and Store locator. These blocks are also available as shortcodes or buttons. You can find out more about them in the next sections.
Search for Local SEO Gutenberg Block
Yoast Structured Data Section
ShortCode Buttons
Map, Address, Opening Hours and Store locator information can be added through the use of a button. These buttons will appear across all posts, pages, and custom post types in the Classic editor.
Map button
Address button
Opening hours button
Store locator button
Map Button
When clicking the 『Map』 shortcode button the following popup will appear. If using blocks with Gutenberg the configuration options will appear on the sidebar.
If you use multiple locations be sure to select the right one from the drop-down box.
As you can see, this is really easy to use! Just select and set everything the way you want! And this map is actually responsive as well, meaning it will resize based on your browser/screen size! If you want to see what they look like live, you can see them on our Local SEO demo site: https://local.yoast.com/maps-examples/ You can also add the map using non-button shortcodes too.
Address Button
When clicking the 『Address』 shortcode button it will show this popup. If using the Gutenberg block the configuration options will appear on the sidebar. You can also add the the address shortcode using a non-button shortcode too. If you use multiple locations be sure to select the right one from the drop-down box. You can also customize it to display the kinds of information useful for your customers.
Opening Hours Button
When clicking the 「Opening hours」 short code button it will show this popup. If using the Gutenberg block the configuration options will appear on the sidebar. You can also add the opening hours using a non-button shortcode too. If you use multiple locations be sure to select the right one from the drop-down box.
Shortcodes
Actual shortcodes may still be used. Here are the shortcodes you can use:
Address shortcode
Map shortcode
Opening Hours shortcode
Store Locator shortcode
Address shortcode
Enter this in the content of your post or page: [wpseo_address]
You can use the following options:
id: the ID of your location. Only use this attribute when you have multiple locations and/or you』re using this shortcode on another page than the location page itself (for example your contact page)oneline: true/false. Whether to have address all on one line.show_state: true/false. Default to true. Whether to show the State/Region or not.show_country: true/false. Default to true. Whether to show the Country or not.show_phone: true/false. Default to true. Whether to show the Phone number or not.show_phone_2: true/false. Whether to show another phone number or not.show_fax: true/false. Whether to show a fax number or not.show_email: true/false. Whether to show an email or notshow_email: true/false. Whether to show an email address or not.show_url: true/false. Whether to show a url or not.show_vat: true/false. Whether to show a vat number or not.show_tax: true/false. Whether to show a tax number or not.show_coc: true/false. Whether to show a Chamber of Commerce ID number or not.show_logo: true/false. Whether to show a logo or not.hide_closed: true/false. Whether you want to hide your closed days or not.comment: Need to enter information. Any information entered between the 」 」 will be displayed.show_opening_hours: true/false. Default to false. Whether to show the opening hours or not. When the opening hours are not filled in it will show 12:00 AM as default text.oneline: true/false. Default to false. Whether to show the address information in one line (true), or one line per address part (false).
Two other parameters if used will result in the business name and the business address from not displaying.
hide_name: true/false. Whether to display the business name or not.hide_address: true/false. Whether to display the business address or not.
Full example using all parameters: Using a one 「1」 or the word 「true」 makes the parameter appear. Using a zero 「0」 or the word 「false」 makes the parameter not appear. Hiding Business Name and Address are not shown in this example.
[wpseo_address id="237" oneline="1" show_state="1" show_country="1" show_phone="1" show_phone_2="1" show_fax="1" show_email="1" show_url="1" show_vat="1" show_tax="1" show_coc="1" show_logo="1" show_opening_hours="1" hide_closed="1" comment="Extra Comment"]
Note: you can also call this function directly in your PHP code. The code below will work if multiple locations have NOT been enabled.:
if( function_exists( 'wpseo_local_show_address' ) ) {
wpseo_local_show_address( array( 'echo' => 'true' ) );
}
You can use the same attributes as described by the shortcode. Therefore you need to pass them as an array, like this:
if( function_exists( 'wpseo_local_show_address' ) ) {
$params = array(
'echo' => true,
'id' => 237,
'show_state' => true,
'show_country' => true,
'show_phone' => true,
'oneline' => false,
);
wpseo_local_show_address( $params );
}
Map shortcode
Enter this in the content of your post or page: [wpseo_map]
You can use the following options:
id: the ID of your location. To show all of your locations (if you have multiple locations of course) use all as value. To show only some locations you can use a comma separated list of location id』s (i.e. id=」58067,51589″)width: number in pixels. Default is 400.height: number in pixels. Default is 300.zoom: number of zoom level. Default is 12. Higher number means more zoomed in.map_style: Describes the kind of map available. Four options are available: roadmap: Shows the Google roadmap hybrid: Shows a hybrid map satellite: Shows a satellite map terrain: Shows a terrain mapscrollable: true/false. Whether to make the map scrollable or not.draggable: true/false. Whether to make the map draggable or not.show_route: true/false. Default to true. Whether to show a form field for using a route planner.Show_state: true/false. Whether to show the state in the info window or not.show_country: true/false. Whether to show the country in the info window or not.show_url: true/false. Whether to show the url in the info window or not.show_email: true/false. Whether to show the email in the info window or not.show_phone: true/false. Shows the primary phone number.show_phone_2: true/false. shows a secondary phone number.show_fax: true/false. Shows the fax numbermarker_clustering: Shows the number of locations in an area when more than 1 location is in close proximity.default_show_infowindow: true/false. Whether to show the info window automatically or not.term_id: the ID of your locations category. This can be used to display all locations from a category in the map.
Full example using all the Map shortcode parameters:Using a one 「1」 or the word 「true」 makes the parameter appear. Using a zero 「0」 or the word 「false」 makes the parameter not appear.
Use the shortcode below as an example
[wpseo_map id="237" width="400" height="300" zoom="-1" map_style="hybrid" scrollable="1" draggable="1" show_route="1" show_state="1" show_country="1" show_url="1" show_email="1" default_show_infowindow="1"]
Note: you can also call this function directly in your PHP code:
if( function_exists( 'wpseo_local_show_map' ) ) {
wpseo_local_show_map();
}
You can use the same attributes as described by the shortcode. Therefore you need to pass them as an array, like this:
if( function_exists( 'wpseo_local_show_map' ) ) {
$params = array(
'echo' => true,
'id' => 347,
'width' => 800,
'height' => 600,
'zoom' => 5,
'show_route' => true
);
wpseo_local_show_map( $params );
}
Opening Hours shortcode
Enter this in the content of your post or page: [wpseo_opening_hours]
You can use the following options:
id: the ID of your location. Only use this attribute when you have multiple locations and/or you』re using this shortcode on another page than the location page itself (for example your contactpage)hide_closed: Whether or not to hide days you are closed. Defaults to 0 which shows closed days. Change to 1 to hide closed days.show_days: Determines which day(s) are displayed. Defaults to all days of the week. Customize by entering the preferred days in a comma separated list. Use lowercase for name of days.comment: Adds a comment to the output. This comment is visible on the front end of your site. Defaults to empty.
Full example:
[wpseo_opening_hours id="43" hide_closed="0" show_days="sunday,monday,tuesday,wednesday,thursday,friday,saturday" comment=""]
Note: you can also call this function directly in your PHP code:
if( function_exists( 'wpseo_local_show_opening_hours' ) ) {
wpseo_local_show_opening_hours( array( 'echo' => true ) );
}
You can use the same attributes as described by the shortcode. Therefore you need to pass them as an array, like this:
if ( function_exists( 'wpseo_local_show_opening_hours' ) ) {
$params = array(
'id' => 237,
'hide_closed' => false,
'echo'=> true,
'comment' => ''
);
wpseo_local_show_opening_hours( $params );
}
Shipping method settings
You can find the shipping method settings by going to:WooCommerce -> Settings -> Shipping (tab) -> Local Store Pickup
Single LocationMultiple LocationsWooCommerce own 「Local pickup」
Single Location
If you have configured only one location in your Local SEO configuration the screen looks like this:
Enable/Disable: let』s you activate or deactivate this shipping method.Checkout text: is a text that is shown during the checkout process. It could provide some information for your customers on the process after the order has been completed. Like: 』You will be notified when your order is ready for pickup』.Local pickup costs: Sets the costs ( if any ) for shipping the order tot hat specific location. Use a positive floating or integer value without taxes here.
Multiple Locations
If you have configured multiple locations and possibly some location categories in your Local SEO configuration the screen looks like this:
Enable/Disable: let』s you activate or de-activate this shipping methodCheckout text: is a text that is shown during the checkout process. It could provide some information for your customers on the process after the order has been completed. Like: 』You will be notified when your order is ready for pickup』.Costs per category: enables you to activate and set the costs for all locations inside a specific location category.Costs per location: enables you to activate and set the costs for specific locations.
Important: Your location specific setting will always override the category specific settings for that location.
WooCommerce』s 「Local pickup」 shipping method
This plugin makes WooCommerce』s Local pickup shipping method superfluous. If you already configured WooCommerce to use it, you will be prompted to disable it when you have enabled Local Store Pickup shipping method.
If you hadn』t configured WooCommerce to use it we disabled the visibility of that shipping method for you and you can』t configure it anymore until you disable Local Store Pickup as a shipping method.
New order statuses
In order to manage your WooCommerce orders properly we created a couple of new order statuses:
Transporting: means that your order has been shipped and is currently in transport tot he local store.Ready for pickup: means that the order has arrived at the local pickup store and can now be picked up by the customers.
To manage this flow we created the Transport overview. You can find it here:
This overview shows a list of all orders that need to be shipped to a local store and has either one of the following statuses: 「Processing」, 「Transporting」 or 「Ready for pickup」.
From this overview you can update the status of a specific order to one of the following statuses: 「Processing」, 「Transporting」, 「Ready for pickup」 or 「Completed」.
Once a customer has pick up his order from the local store you can set the status to 「Completed」 and the order will disappear from this overview.
New order statuses mails
Along with the new order statuses we created a couple of extra e-mails in the order process. So we can notify customers when a status has been changed. We created e-mails for when the status changes:
From 「Processing」 to 「Transporting」From 「Transporting」 to 「Ready for Pickup」
You can configure WooCommerce e-mails settings here:WooCommerce -> Settings -> Email (tab)
The checkout process
If you have enabled and configured the locations and the shipping method correctly The location will appear as a shipping option during the checkout process.
We have altered the regular checkout process when using a local store pickup to make it more logical for our purpose.
We adjusted the following items:
We removed the 「Shipping address」 from the overview. We don』t need it anymore since we are shipping to a local store.We added the checkout text which you can configure in the shipping methodWe changed the taxable address and thus the tax calculation to the address of the local store
Example:
[wpseo_address id=」237″ oneline=」1″ show_state=」1″ show_country=」1″ show_phone=」1″ show_phone_2=」1″ show_fax=」1″ show_email=」1″ show_url=」1″ show_vat=」1″ show_tax=」1″ show_coc=」1″ show_logo=」1″ show_opening_hours=」1″ hide_closed=」1″ comment=」Extra Comment」]
Developer filters
Remove Locations from the Permalink This filter goes into the functions.php and will remove the Locations word from the permalink. If the new permalink returns a 404, please go to Admin > Settings > Permalinks and click save without altering anything. ( How to Guide available here.)
If you are not sure how to use the code or add it to your site, you may wish to use a Yoast Partner who can help. As a best practice we recommend taking a back-up of the site prior to making any changes on it. If you are not sure how to take a back-up, your host provider can help.
add_filter( 'post_type_link', 'remove_cpt_slug', 10, 3 );
function remove_cpt_slug( $post_link, $post, $leavename ) {
$options = get_option('wpseo_local');
$slug = ! empty( $options['locations_slug'] ) ?
$options['locations_slug'] : 'locations';
if ( ! in_array( $post->post_type, array( 'wpseo_locations' ) ) && ( 'publish' != $post->post_status || 'draft' != $post->post_status ) ) {
return $post_link;
}
$post_link = str_replace( '/' .$slug . '/', '/', $post_link );
return $post_link;
};
Without Filter see the Locations word in permalink
With filter see the Locations word removed from permalink
Show Route Filter You can adjust the size of the Route title name that appears beneath the Google Map. By default it is set to an h3 title tag. You can change it by entering the following filter in your functions.php. Change the h3 to an h1 or h2 etc. to adjust the size.
apply_filters( 'wpseo_local_location_route_title_name', 'h3' );
That』s it! Of course, if you have company videos, you should be optimizing those with our Video SEO plugin!
Filter to change business details labels
This is an example on how to change the name of a label for the contact details.
add_filter( 'wpseo_local_contact_details', 'wpseo_local_alter_contact_details', 10, 1 );
function wpseo_local_alter_contact_details( $business_contact_details ) {
foreach( $business_contact_details as $order => $details ) {
if( 'phone_2' === $details['key'] ) {
$business_contact_details[$order]['label'] = 'My new 2nd phone number label';
}
}
return $business_contact_details;
}
Edit Google Map Information and Details
Changing the Location URL in Google Maps
To change the Location URL in Google Maps, you can use the following filter tag.
yoast_seo_local_change_map_location_url
For more information, please refer to this guide: Changing the Location URL in Google Maps.
Edit Location Archive Template Files
Use this guide here.
