Article Locations

Article locations let you inject content at precise positions within a Joomla article — below the title, at the start or end of the body, or around a specific paragraph. They are ideal for adding contextual elements such as advertisements, newsletter sign-up forms, author bios, social sharing buttons, reading-time indicators, or call-to-action boxes that are directly tied to the article being read.

Available Article Locations

After Article Title

Inserts content directly below the article title, before the article body begins. This is the natural home for metadata and orientation elements that help readers decide whether to continue reading, for example, author information, publication date, social sharing buttons placed at the top, article summaries or excerpts, or an inline table of contents for long-form articles.

Before Article Content

Inserts content at the very beginning of the article body, before the first paragraph. This is a high-visibility position visible to every reader, making it well-suited for notices that must not be missed, such as call-to-action boxes, newsletter sign-up forms, important update notices, sponsored-content disclosures, or introductory video embeds.

After Article Content

Inserts content at the end of the article body, after the last paragraph. Readers who reach this point have consumed the full article, making it the highest-intent position on the page. Use it for related-article lists, author bio boxes, comments prompts, bottom social-sharing buttons, next-article suggestions, or closing advertisements.

Before Article Paragraph

Inserts content immediately before a specific paragraph in the article body. You set the Paragraph Number (1-based) to control the exact position. If the number you specify exceeds the total paragraph count, the content is prepended to the start of the article body as a fallback.

This location is ideal for placements that need to appear at a consistent reading depth rather than at a fixed structural position, for example, mid-article lead-generation forms, contextual callout boxes before a key section, ad slots before a specific paragraph, or warning notices placed just ahead of critical content.

After Article Paragraph

Inserts content immediately after a specific paragraph in the article body. You set the Paragraph Number (1-based) to control the exact position. If the number exceeds the total paragraph count, the content is appended to the end of the article body as a fallback.

This location works well for in-content advertisements at a consistent depth, content upgrades or downloadable resources offered mid-article, social-sharing prompts placed after an engaging opening, or contextual product recommendations tied to a particular section.

Supported Snippet Types

Article locations are supported only in the HTML and Text snippet types.

Targeting Specific Articles

By default, a snippet assigned to an article location will appear on every article. Use the conditions below to restrict it to only the articles you intend.

You can combine multiple conditions in a single snippet using Snippet Logic for advanced targeting scenarios.

Troubleshooting

Snippet does not appear

• Article view only. Article locations fire exclusively during the single-article view. If you are browsing a blog layout, a category list, or a featured-articles page, the snippet will not be injected. Navigate directly to the article's detail page and test there.
• Template must trigger Joomla content events. Article locations rely on Joomla's onContentPrepare and related content events. If your template or a third-party page builder bypasses these events and renders article content directly, the locations will not fire. Verify that your template dispatches the standard Joomla content events.
• Paragraph-based locations require <p> tags. The Before/After Article Paragraph locations work by counting <p> elements in the article HTML. If your article content uses headings, <div> blocks, or other elements instead of <p> tags, no paragraphs will be matched. Ensure your article text is structured with proper paragraph tags, or switch to Before/After Article Content as an alternative.

Paragraph snippet appears at the wrong position

1. Check the paragraph count. If the Paragraph Number you configured is higher than the number of <p> tags in the article, the snippet falls back to the start (Before) or end (After) of the article body.
2. Only <p> tags are counted. Headings (<h1>–<h6>), list items, and other block elements are not counted as paragraphs.
3. Clear caches. Stale Joomla page cache or browser cache can serve an outdated version of the page. Clear both and reload.

Snippet appears on the wrong articles

Review your category and article ID filters, and check any conditions configured under Snippet Logic to ensure they match only the intended articles.

Snippet appears in the wrong location

Even when a template correctly triggers Joomla's content events, different templates call those events at different points in their HTML structure. This means the same location can render in a slightly different position on the page depending on which template is active — for example, one template may fire onContentAfterTitle inside the article card while another fires it outside.

To determine whether your template is the cause, temporarily switch to a Joomla core template such as Atom and verify whether the snippet appears in the expected position. If it does, the issue is specific to your template's layout and you will need to adjust accordingly or contact the template author.