# SEO Portal

This feature allows users to configure the **Meta Title**, **Meta Description**, and **Meta Image** for any shared workspace or custom domain (e.g., client portal or project page). This ensures a consistent and professional look when links are shared across platforms like **LinkedIn, Slack, WhatsApp**, and more. Additionally, users can reset all custom metadata to default settings with a single click.

### Goals

* Enable users to customize the **Meta Title** and **Meta Description** for link previews.
* Allow users to upload a custom image that appears in link previews.
* Ensure previews are consistent and attractive across different platforms.

### Pre-conditions

🛠️ **Permissions Required:** Only **Super Admins** and **Admins** can configure this feature.

🌐 **Domain Access:** The workspace or custom domain must be verified and linked correctly.

***

### Table of Contents

1. [Accessing the Meta Settings](#id-1.-accessing-the-meta-settings)
2. [Configuring Meta Title, Description & Image](#id-2.-configuring-meta-title-description-and-image)
3. [Previewing Your Changes](#id-3.-previewing-your-changes)
4. [Resetting to Default Metadata](#id-4.-resetting-to-default-metadata)
5. [Best Practices for Metadata](#id-5.-best-practices-for-metadata)
6. [Troubleshooting Common Issues](#id-6-troubleshooting-common-issues)

***

### 1. Accessing the Meta Settings

1. Log in to your **Agency Handy** account.
2. Navigate to **Workspace Settings** → **Portal** **SEO**.
3. Click on **Meta Title & Description Settings**.

📌 *Make sure you have Admin access to see these options.*

***

<figure><img src="/files/IF85FMZzIReRD4z8V32b" alt=""><figcaption></figcaption></figure>

### 2. Configuring Meta Title, Description & Image

#### Meta Title:

* Enter a custom **Meta Title** (Optional, max 120 characters).
* This title appears as the main heading in the link preview.

💡 *Tip: Keep it concise and descriptive for better visibility.*

***

#### Meta Description:

* Enter a custom **Meta Description** (Optional, max 300 characters).
* This text appears as the description in the link preview.

💡 *Tip: Summarize key benefits or important information in this space.*

***

#### Meta Image:

* Upload a custom **Meta Image** (Optional).
* Supported formats: **JPEG, PNG, JPG**.
* Recommended size: **1200×630 px**, max size 5 MB.

⚠️ *Ensure the image is clear, professional, and represents your brand effectively.*

***

### 3. Previewing Your Changes

1. During the changes, look at the right side to check how it looks.
2. A mockup of the link preview will appear, showing how it will look on platforms like **LinkedIn, Slack, WhatsApp**, etc.
3. If adjustments are needed, edit the fields and click **Save Changes**.

***

### 4. Resetting to Default Metadata

* Click the **Reset to Default** button in the top right corner of the page.
* This action will revert all fields to the default workspace settings.

⚠️ *This action is irreversible. Ensure you want to reset before proceeding.*

***

### 5. Best Practices for Metadata

* **Title:** Use clear, specific titles that reflect the workspace's purpose.
* **Description:** Highlight key benefits or important information.
* **Image:** Use a clean, branded image that reflects professionalism.

***

### 6. Troubleshooting Common Issues

* **Image not displaying correctly:** Ensure it is within the size limit ( 5 MB ) and in a supported format.
* **Title or description missing in previews:** Clear browser cache and refresh the link preview.
* **Link not updating on social platforms:** Social platforms cache metadata. Use tools like Facebook Debugger to refresh the cache.

***

*You have successfully configured the Meta Title, Description, and Image for your workspace link. Your link previews will now appear professional and consistent across all platforms.*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.agencyhandy.com/english/agencyhandy-user-guide-for-agency/workspace-config/seo-portal.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.