# 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="https://842362573-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiedbxyF6rrnGBuHuFME1%2Fuploads%2FG8EYaGfahPbo6LtoxpU5%2FScreenshot_154.png?alt=media&#x26;token=2f7cf333-3861-462e-9203-3912b402aab9" 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.*
