Skip to content

Commit afbf162

Browse files
committed
[IMP] website: SEO indexation section restructure
task-5003440
1 parent 01b5bd7 commit afbf162

File tree

6 files changed

+108
-57
lines changed

6 files changed

+108
-57
lines changed

content/applications/websites/website/structure/seo.rst

Lines changed: 108 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -65,21 +65,8 @@ keywords to drive your web traffic. The more keywords are present on your webpag
6565
.. tip::
6666
It is strongly recommended to only use one H1 title per page for SEO.
6767

68-
Image for social share
69-
----------------------
70-
71-
When you share your page on social media, your logo image is selected, but you can upload any other
72-
image by clicking the upward arrow.
73-
74-
.. Note::
75-
- The :guilabel:`Social Preview` card displays how the page's information would appear when
76-
shared.
77-
- If you change the title of a blog post or the name of a product, the changes apply
78-
automatically everywhere on your website. The old link still functions when external websites
79-
use a :ref:`301 redirect <website/pages/URL-redirection>`, maintaining the SEO link juice.
80-
8168
Images
82-
======
69+
------
8370

8471
The size of images has a significant impact on page speed, which is an essential criterion for
8572
search engines to optimize SEO ranking.
@@ -97,39 +84,56 @@ efficiently.
9784
**To modify an image** from your website, select the image, click :guilabel:`Edit`, then go to the
9885
:guilabel:`Customize` tab, and adapt the :guilabel:`Format` in the :guilabel:`Image` section.
9986

100-
.. image:: seo/image-format.png
101-
:alt: automated image compression
102-
10387
.. important::
10488
Alt tags are used to provide context to what an image is displaying, informing search engine
10589
crawlers and allowing them to index an image correctly. Adding alt tags keywords in the
10690
:guilabel:`Description` field is essential from an SEO perspective. This description is added to
10791
the HTML code of your image, and it is shown when the image cannot be displayed.
10892

109-
Advanced features
110-
=================
93+
Image for social share
94+
~~~~~~~~~~~~~~~~~~~~~~
11195

112-
Structured data markup
113-
----------------------
96+
When you share your page on social media, your logo image is selected, but you can upload any other
97+
image by clicking the upward arrow.
11498

115-
Structured data markup is used to generate rich snippets in search engine results. It is a way for
116-
websites to send structured data to search engine robots, helping them understand your content and
117-
create well-presented search results.
99+
.. Note::
100+
- The :guilabel:`Social Preview` card displays how the page's information would appear when
101+
shared.
102+
- If you change the title of a blog post or the name of a product, the changes apply
103+
automatically everywhere on your website. The old link still functions when external websites
104+
use a :ref:`301 redirect <website/pages/URL-redirection>`, maintaining the SEO link juice.
118105

119-
By default, Google supports many `rich snippets <https://developers.google.com/search/blog/2009/05/introducing-rich-snippets>`_
120-
for content types, including Reviews, People, Products, Businesses, Events, and Organizations.
106+
Sitemap
107+
=======
121108

122-
Microdata is a set of tags, introduced with HTML5, that help search engines better understand your
123-
content and display it in a relevant way. Odoo implements microdata as defined in the schema.org
124-
`specification <https://schema.org/docs/gs.html>`_ for events, eCommerce products, forum posts, and
125-
contact addresses. This allows your product pages to be displayed in Google using extra information
126-
like the price and rating of a product:
109+
The sitemap points out website pages and their relation to each other to search engine robots. Odoo
110+
generates a `/sitemap.xml` file, including all URLs. For performance reasons, this file is cached
111+
and updated every 12 hours.
127112

128-
.. image:: seo/data-markup.png
129-
:alt: snippets in search engine results
113+
.. note::
114+
If your website has a lot of pages, Odoo automatically creates a Sitemap Index file, respecting
115+
the `sitemaps.org protocol <http://www.sitemaps.org/protocol.html>`_, grouping sitemap URLs in
116+
45000 chunks per file.
117+
118+
Every sitemap entry has three attributes that are computed automatically:
119+
120+
- `<loc>`: the URL of a page.
121+
- `<lastmod>`: last modification date of the resource, computed automatically based on the related
122+
object. For a page related to a product, this could be the last modification date of the product
123+
or the page.
124+
- `<priority>`: modules may implement their priority algorithm based on their content (for example,
125+
a forum might assign a priority based on the number of votes on a specific post). The priority of
126+
a static page is defined by its priority field, which is normalized (16 is the default).
127+
128+
.. tip::
129+
To prevent pages from appearing in a sitemap, go to :menuselection:`Site --> Properties`, and
130+
toggle off the :guilabel:`Indexed` feature.
131+
132+
.. image:: seo/page-properties.png
133+
:alt: toggle off the “Indexed” field
130134

131135
robots.txt
132-
----------
136+
==========
133137

134138
A `robots.txt` file instructs search engine crawlers which parts of a website they are permitted to
135139
access. Its primary purpose is to:
@@ -148,7 +152,7 @@ creates one robot.txt file available on `mydatabase.odoo.com/robots.txt`.
148152
:ref:`Cloudflare <domain-name/naked/cloudflare>` on your custom domain.
149153

150154
Edit robots.txt
151-
~~~~~~~~~~~~~~~
155+
---------------
152156

153157
By editing a robots.txt file, you can control which site pages are accessible to search engine
154158
crawlers. To add custom instructions to the file, go to :menuselection:`Website --> Configuration
@@ -164,6 +168,45 @@ crawlers. To add custom instructions to the file, go to :menuselection:`Website
164168
crawled pages (indexed by "reference"). Google generally does not recommend using robots.txt to
165169
block webpages that you wish to keep out of search results entirely.
166170

171+
Indexation
172+
==========
173+
174+
Website indexation is the process by which search engines, such as Google, discover, analyze, and
175+
store information about a website's content in their database. Search engine bots, known as crawlers
176+
or spiders, visit web pages and follow links to collect data, including text, images, and other
177+
media. The purpose of indexation is to make a website's content searchable and discoverable to
178+
users. Without being indexed, a website or a specific page on that site will not appear in search
179+
engine results, regardless of how relevant or well-designed it is. Indexation is a fundamental step
180+
in :abbr: `SEO (Search Engine Optimization)`, serving as the foundation for a website's visibility
181+
and organic traffic.
182+
183+
.. note::
184+
When creating your Odoo website, this one will not appear directly on search engines. Your
185+
previous website may still appear instead of the new one. Google controls the indexing process,
186+
which can take several days or weeks. You can connect Search Console through Odoo settings and
187+
request indexing for specific URLs, though this does not guarantee faster results.
188+
189+
SEO impact when migrating your previous website to Odoo
190+
-------------------------------------------------------
191+
192+
In most cases, migrating to Odoo will not negatively impact your SEO. While no platform can
193+
guarantee that rankings will remain unchanged, following best practices significantly reduces the
194+
risk.
195+
196+
To preserve your SEO:
197+
198+
- Keep your existing content.
199+
200+
- Implement :ref:`redirects <website/pages/URL-redirection>` from old URLs to their new counterparts.
201+
202+
- Monitor traffic and indexation to make sure that everything is going well, using :doc:`../configuration/google_search_console`.
203+
204+
By following all these steps, search engines can properly index your site and maintain your
205+
visibility.
206+
207+
.. note::
208+
It is normal to experience a traffic decrease in the firsts days.
209+
167210
Prevent a page from being indexed
168211
---------------------------------
169212

@@ -191,34 +234,42 @@ methods:
191234
- :doc:`../configuration/google_search_console`
192235
- :doc:`pages`
193236

194-
Sitemap
195-
-------
237+
Prevent the website of a test database from appearing in search results
238+
-----------------------------------------------------------------------
196239

197-
The sitemap points out website pages and their relation to each other to search engine robots. Odoo
198-
generates a `/sitemap.xml` file, including all URLs. For performance reasons, this file is cached
199-
and updated every 12 hours.
240+
To prevent a test database website from appearing in search engine results, add any placeholder
241+
value in the domain field. Go to :menuselection:`Configuration --> Settings`, then in
242+
the :guilabel:`Website Info` section, add a random value in the :guilabel:`Domain` field. Doing so
243+
automatically inserts the following tag into the page source:
200244

201-
.. note::
202-
If your website has a lot of pages, Odoo automatically creates a Sitemap Index file, respecting
203-
the `sitemaps.org protocol <http://www.sitemaps.org/protocol.html>`_, grouping sitemap URLs in
204-
45000 chunks per file.
245+
.. code-block:: html
205246

206-
Every sitemap entry has three attributes that are computed automatically:
247+
<meta name="robots" content="noindex"/>
207248

208-
- `<loc>`: the URL of a page.
209-
- `<lastmod>`: last modification date of the resource, computed automatically based on the related
210-
object. For a page related to a product, this could be the last modification date of the product
211-
or the page.
212-
- `<priority>`: modules may implement their priority algorithm based on their content (for example,
213-
a forum might assign a priority based on the number of votes on a specific post). The priority of
214-
a static page is defined by its priority field, which is normalized (16 is the default).
249+
This tag instructs search engines not to index the site. After applying the change, it may take
250+
several days or weeks for search engines to update their results and remove the test website.
215251

216-
.. tip::
217-
To prevent pages from appearing in a sitemap, go to :menuselection:`Site --> Properties`, click
218-
the :guilabel:`Publish` tab, and turn off the :guilabel:`Indexed` feature.
252+
Advanced features
253+
=================
219254

220-
.. image:: seo/page-properties.png
221-
:alt: disabling the “Indexed” checkbox
255+
Structured data markup
256+
----------------------
257+
258+
Structured data markup is used to generate rich snippets in search engine results. It is a way for
259+
websites to send structured data to search engine robots, helping them understand your content and
260+
create well-presented search results.
261+
262+
By default, Google supports many `rich snippets <https://developers.google.com/search/blog/2009/05/introducing-rich-snippets>`_
263+
for content types, including Reviews, People, Products, Businesses, Events, and Organizations.
264+
265+
Microdata is a set of tags, introduced with HTML5, that help search engines better understand your
266+
content and display it in a relevant way. Odoo implements microdata as defined in the schema.org
267+
`specification <https://schema.org/docs/gs.html>`_ for events, eCommerce products, forum posts, and
268+
contact addresses. This allows your product pages to be displayed in Google using extra information
269+
like the price and rating of a product:
270+
271+
.. image:: seo/rich-snippet.png
272+
:alt: snippets in search engine results
222273

223274
Hreflang HTML tags
224275
------------------
Binary file not shown.
Binary file not shown.
-26.8 KB
Loading
24.5 KB
Loading
369 KB
Loading

0 commit comments

Comments
 (0)