> ## Documentation Index
> Fetch the complete documentation index at: https://learn.social.plus/llms.txt
> Use this file to discover all available pages before exploring further.

# Edit User Content with Change History

> Modify user-generated content with full transparency and accountability through comprehensive edit tracking and change history management

Empower your moderation team to maintain content quality and compliance by enabling direct editing of user-generated posts and comments through the Console. All modifications are tracked in a comprehensive change history, ensuring transparency, accountability, and audit compliance.

<Info>
  **Key Benefit**: Moderators can correct content violations and enforce community standards without deleting entire posts, while maintaining full transparency through automated change tracking.
</Info>

<CardGroup cols={3}>
  <Card title="Direct Content Editing" icon="pencil">
    Modify text, media, and metadata for posts and comments
  </Card>

  <Card title="Comprehensive History" icon="clock-rotate-left">
    Track all edits with timestamps, actors, and reasons
  </Card>

  <Card title="Granular Permissions" icon="shield-check">
    Control who can edit content with role-based access
  </Card>

  <Card title="Compliance Ready" icon="file-contract">
    Full audit trail for regulatory and policy enforcement
  </Card>

  <Card title="Quality Control" icon="badge-check">
    Remove sensitive information while preserving content
  </Card>

  <Card title="Transparent Moderation" icon="eye">
    Users see edit indicators and moderators see full history
  </Card>
</CardGroup>

## Overview

The Edit User Content feature enables authorized moderators to:

1. **Modify Content**: Edit text, media, and metadata for user posts and comments
2. **Add Context**: Optionally include reasons for edits to improve transparency
3. **Track Changes**: Automatically maintain a comprehensive change history
4. **Enforce Standards**: Remove violations while preserving valuable content
5. **Maintain Compliance**: Ensure all modifications meet community guidelines

## Key Capabilities

<AccordionGroup>
  <Accordion title="Content Modification Options">
    **Post Editing:**

    * **Text Posts**: Edit title and content
    * **Image Posts**: Edit title, content, add/remove/reorder images, modify alt text
    * **Video Posts**: Edit title, content, add/remove/reorder videos, modify alt text
    * **File Posts**: Edit title, content, add/remove/reorder files, modify alt text
    * **Clip Posts**: Edit caption only

    **Comment Editing:**

    * Edit text content
    * Support for both comments and replies
    * Preserve threading and context

    **Restrictions:**

    * ❌ Cannot edit poll posts
    * ❌ Cannot edit stories
    * ❌ Cannot edit livestream posts
    * ❌ Cannot edit scheduled posts
    * ❌ Cannot edit deleted posts
  </Accordion>

  <Accordion title="Change History Tracking">
    **What's Tracked:**

    * Original version with creator details
    * All edited versions with modifications
    * Edit timestamps and dates
    * Editor identity (moderator/admin)
    * Optional edit reasons
    * Media additions and removals
    * Deleted child posts

    **History Display:**

    * Latest to oldest chronological order
    * Up to 10 most recent edit versions
    * Original version always visible
    * Clear visual indicators for changes
    * Media deletion status (when feasible)
  </Accordion>

  <Accordion title="Permissions & Access Control">
    **New Permission: "Edit posts and comments"**

    * Separate from "Manage posts and comments"
    * Available to Admin role by default
    * Granular control over editing capabilities

    **Access Requirements:**

    * Must have explicit edit permissions
    * Available in Console/Portal only
    * Subject to role hierarchy
    * Audit logged for all actions
  </Accordion>

  <Accordion title="Validation & Error Handling">
    **Content Validation:**

    * Block word detection during editing
    * Character limit enforcement
    * Media format validation
    * Metadata structure checks

    **Error States:**

    * Block word violation alerts
    * API connection failures
    * Network connectivity issues
    * Concurrent edit conflicts
  </Accordion>
</AccordionGroup>

## Getting Started

<Steps>
  <Step title="Verify Permissions">
    Ensure your admin account has the "Edit posts and comments" permission. Navigate to **Admin users** → **Roles & permissions** to verify role permissions.
  </Step>

  <Step title="Locate Content">
    Find the content you want to edit through:

    * **Posts & Comments** page
    * **User History** page
  </Step>

  <Step title="Access Edit Mode">
    Click the **⋮** → **Edit** button on the content you want to modify. The edit interface will display based on content type.
  </Step>

  <Step title="Make Modifications">
    Edit the content according to your moderation needs:

    * Update text content
    * Add, remove, or reorder media
    * Modify alt text for accessibility
    * Adjust metadata as needed
  </Step>

  <Step title="Add Edit Reason (Optional)">
    Provide a clear reason for the edit to improve transparency and maintain audit compliance. This appears in the change history.
  </Step>

  <Step title="Save Changes">
    Review your modifications and click **Save**. The system will validate content and update both the Console and user-facing views.
  </Step>

  <Step title="Verify Changes">
    Confirm that:

    * Content displays correctly
    * "View change history" indicator appears
    * Change history is updated
    * Edit appears in moderation activity report
  </Step>
</Steps>

## Permission Management

### Setting Up Edit Permissions

<Tabs>
  <Tab title="Console Configuration">
    ### Admin Role Permissions

    The "Edit posts and comments" permission is automatically available to the **Admin** role and can be viewed in the Admin Roles section.

    **To View Permissions:**

    <Steps>
      <Step title="Navigate to Admin Roles">
        Go to **Settings** → **Admin Roles** in the Console
      </Step>

      <Step title="Select Role">
        Click on the **Admin** role to view details
      </Step>

      <Step title="Review Permissions">
        Locate "Edit posts and comments" in the permissions list
      </Step>
    </Steps>

    <Info>
      The "Edit posts and comments" permission is distinct from "Manage posts and comments" and provides specific editing capabilities without full content management access.
    </Info>
  </Tab>

  <Tab title="Best Practices">
    ### Permission Assignment Guidelines

    <AccordionGroup>
      <Accordion title="Role Design Principles">
        **Separation of Duties:**

        * Create distinct roles for different moderation tasks
        * Separate editing from deletion and banning powers
        * Use "Edit posts and comments" for content refinement
        * Use "Manage posts and comments" for full content lifecycle

        **Principle of Least Privilege:**

        * Grant only necessary permissions for each role
        * Review permissions regularly
        * Audit role usage patterns
        * Remove unused or excessive permissions
      </Accordion>

      <Accordion title="Team Structure">
        **Recommended Role Hierarchy:**

        1. **Content Editors**: Edit permissions only
        2. **Community Moderators**: Edit + basic moderation
        3. **Senior Moderators**: Edit + full moderation
        4. **Administrators**: All permissions

        **Scaling Considerations:**

        * Small teams: Fewer, broader roles
        * Large teams: More specialized roles
        * Global teams: Regional role assignments
        * Contractor teams: Limited permission sets
      </Accordion>

      <Accordion title="Compliance & Auditing">
        **Audit Requirements:**

        * Log all permission changes
        * Review edit actions monthly
        * Track editor performance metrics
        * Maintain permission documentation

        **Regulatory Considerations:**

        * Document edit reason requirements
        * Establish edit approval workflows
        * Define retention policies for change history
        * Ensure GDPR/CCPA compliance
      </Accordion>
    </AccordionGroup>
  </Tab>
</Tabs>

## Editing Content

### Post Editing Workflows

<Tabs>
  <Tab title="Text Posts">
    ### Editing Text Posts

    Text posts support comprehensive editing of title and content fields.

    **Available Edits:**

    * Title modification
    * Content text updates
    * Metadata adjustments

    **Edit Process:**

    <Steps>
      <Step title="Open Post Editor">
        Click **Edit** on the text post you want to modify
      </Step>

      <Step title="Modify Content">
        Update the title and/or content fields as needed
      </Step>

      <Step title="Add Reason">
        Optionally add an edit reason (e.g., "Removed profanity", "Corrected misinformation")
      </Step>

      <Step title="Validate Changes">
        System automatically checks for block words and policy violations
      </Step>

      <Step title="Save Updates">
        Click **Save** to publish the edited content
      </Step>
    </Steps>

    **Example Use Cases:**

    <CardGroup cols={2}>
      <Card title="Content Refinement" icon="wand-magic-sparkles">
        Remove profanity or offensive language while preserving the post's intent and value
      </Card>

      <Card title="Accuracy Corrections" icon="spell-check">
        Fix factual errors, correct misinformation, or update outdated information
      </Card>

      <Card title="Privacy Protection" icon="user-shield">
        Remove personal information, contact details, or sensitive data
      </Card>

      <Card title="Compliance Enforcement" icon="gavel">
        Modify content to meet legal requirements or community guidelines
      </Card>
    </CardGroup>
  </Tab>

  <Tab title="Media Posts">
    ### Editing Image, Video & File Posts

    Media posts support extensive editing including content, media management, and accessibility features.

    **Available Edits:**

    * Title and content text
    * Add new media files
    * Remove existing media
    * Reorder media items
    * Update alt text for accessibility

    **Media Management:**

    <Steps>
      <Step title="Access Media Editor">
        Click **Edit** on any image, video, or file post
      </Step>

      <Step title="Edit Text Content">
        Modify title and description as needed
      </Step>

      <Step title="Manage Media Files">
        * **Add**: Upload new images, videos, or files
        * **Remove**: Delete inappropriate or unwanted media
        * **Reorder**: Drag and drop to change media sequence
      </Step>

      <Step title="Update Accessibility">
        Edit alt text descriptions for screen readers and accessibility compliance
      </Step>

      <Step title="Add Edit Reason">
        Document why media was modified (e.g., "Removed copyrighted image", "Added accessibility text")
      </Step>

      <Step title="Save Changes">
        Review all modifications and save to publish updates
      </Step>
    </Steps>

    <Warning>
      **Media Deletion**: When removing media files, the change history will show a preview as deleted media. But won't preserve the actual media file itself.
    </Warning>

    **Example Scenarios:**

    <AccordionGroup>
      <Accordion title="Copyright Compliance">
        **Situation**: User uploaded copyrighted images without permission

        **Action**:

        * Remove copyrighted images
        * Keep other original media
        * Add edit reason: "Removed copyrighted content"
        * Preserve post for community visibility
      </Accordion>

      <Accordion title="Inappropriate Content">
        **Situation**: Post contains mix of appropriate and inappropriate images

        **Action**:

        * Remove offensive images only
        * Maintain appropriate content
        * Update post description if needed
        * Document removal reason
      </Accordion>

      <Accordion title="Accessibility Enhancement">
        **Situation**: Media lacks proper alt text descriptions

        **Action**:

        * Add descriptive alt text for all media
        * Improve accessibility compliance
        * Enhance user experience for screen readers
        * Note: "Added accessibility descriptions"
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Clip Posts">
    ### Editing Clip Posts

    Clip posts have limited editing capabilities focused on captions.

    **Clip Posts:**

    * Edit caption text only
    * Cannot modify video content
    * Can add edit reasons

    **Edit Process:**

    <Steps>
      <Step title="Select Post Type">
        Navigate to the clip post
      </Step>

      <Step title="Click Edit">
        Open the simplified editor for caption modification
      </Step>

      <Step title="Update Text">
        Modify the caption (clips)
      </Step>

      <Step title="Add Context">
        Provide edit reason for transparency
      </Step>

      <Step title="Save Changes">
        Publish the updated caption
      </Step>
    </Steps>

    <Info>
      **Design Rationale**: Clip posts have limited editing to preserve the integrity of time-sensitive or real-time content. Only metadata can be modified.
    </Info>
  </Tab>
</Tabs>

### Comment Editing

<Tabs>
  <Tab title="Comment Workflow">
    ### Editing Comments and Replies

    Comments and replies support text-only editing to maintain threading integrity.

    **Available Edits:**

    * Text content modification
    * Support for comments and replies
    * Preserve threading context

    **Edit Steps:**

    <Steps>
      <Step title="Locate Comment">
        Find the comment in:

        * Posts & Comments page
        * User History page
        * Moderation Feed
      </Step>

      <Step title="Open Editor">
        Click **Edit** on the comment or reply
      </Step>

      <Step title="Modify Text">
        Update the comment text as needed
      </Step>

      <Step title="Add Reason">
        Document why the comment was edited
      </Step>

      <Step title="Validate">
        System checks for block words and violations
      </Step>

      <Step title="Save Updates">
        Publish the edited comment
      </Step>
    </Steps>
  </Tab>

  <Tab title="Best Practices">
    ### Comment Editing Guidelines

    <AccordionGroup>
      <Accordion title="When to Edit vs Delete">
        **Edit Comments When:**

        * Minor policy violations (profanity, spam elements)
        * Valuable discussion with problematic elements
        * Educational opportunity (show corrected version)
        * Context preservation is important

        **Delete Comments When:**

        * Severe policy violations (harassment, threats)
        * Entirely inappropriate content
        * Spam or bot-generated content
        * Legal removal requirements
      </Accordion>

      <Accordion title="Maintaining Context">
        **Threading Integrity:**

        * Preserve conversation flow
        * Don't alter meaning drastically
        * Consider reply context
        * Maintain chronological sense

        **Communication:**

        * Use clear edit reasons
        * Be transparent about changes
        * Document policy violations
        * Provide user guidance when possible
      </Accordion>

      <Accordion title="Quality Standards">
        **Editorial Principles:**

        * Minimal necessary changes
        * Preserve user voice when possible
        * Fix violations without rewriting
        * Maintain factual accuracy

        **Consistency:**

        * Apply same standards across all comments
        * Use standardized edit reasons
        * Follow escalation procedures
        * Document decision rationale
      </Accordion>
    </AccordionGroup>
  </Tab>
</Tabs>

## Change History

### Understanding Change History

<Tabs>
  <Tab title="History Display">
    ### Viewing Change History

    Every edited post or comment maintains a comprehensive change history accessible to moderators.

    **Access Points:**

    <CardGroup cols={3}>
      <Card title="Post & Comment Page" icon="file-lines">
        View history from main content pages
      </Card>

      <Card title="User History Page" icon="user-clock">
        Access from user profile sections
      </Card>

      <Card title="Activity Reports" icon="chart-line">
        Historical data in moderation reports
      </Card>
    </CardGroup>

    **History Contents:**

    <Steps>
      <Step title="Original Version">
        * Complete original content
        * Creator name and details
        * Creation date and timestamp
        * Original media attachments
      </Step>

      <Step title="Edit Entries">
        * Updated text content
        * Media additions/removals
        * Edit date and timestamp
        * Editor (moderator/admin) identity
        * Edit reason (if provided)
      </Step>

      <Step title="Chronological Order">
        * Latest edit at top
        * Up to 10 recent edits shown
        * Original version always visible
        * Clear version numbering
      </Step>
    </Steps>

    <Info>
      **History Limit**: The system displays the 10 most recent edit versions plus the original post. If content has been edited more than 10 times, only the latest 10 edits are shown.
    </Info>
  </Tab>

  <Tab title="History Details">
    ### What's Tracked in History

    <AccordionGroup>
      <Accordion title="Original Version">
        **Complete Original Content:**

        * Full text content (title, body, captions)
        * All original media attachments
        * Creator user information
        * Creation timestamp (date and time)
        * Original metadata and tags
        * Initial engagement metrics

        **Preservation:**

        * Always retained in history
        * Never overwritten or deleted
        * Serves as baseline for comparison
        * Maintains attribution integrity
      </Accordion>

      <Accordion title="Edited Versions">
        **For Each Edit:**

        * **Text Changes**: Updated title, content, captions
        * **Media Changes**: Added/removed/reordered files
        * **Timestamp**: Exact date and time of edit
        * **Editor Identity**: Moderator/admin who made changes
        * **Edit Reason**: Optional explanation (if provided)
        * **Deleted Child Posts**: References to removed nested content

        **Version Information:**

        * Sequential version numbering
        * Clear change indicators
        * Before/after comparisons
        * Visual diff highlighting (when applicable)
      </Accordion>

      <Accordion title="Special Cases">
        **Concurrent Edits:**

        * All versions preserved if multiple moderators edit simultaneously
        * Latest saved version displays to users
        * All versions visible in history
        * Timestamp determines display order

        **Deleted Content:**

        * Change history removed when post is deleted
        * Edits not preserved after deletion
        * Consider archiving before deletion if needed

        **Media Deletion:**

        * System attempts to show deleted media preview
        * Fallback to deletion indicator if preview unavailable
        * Media filename and type preserved
        * Reason for removal documented
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Using History">
    ### Practical Applications

    <AccordionGroup>
      <Accordion title="Audit & Compliance">
        **Regulatory Requirements:**

        * Complete edit trail for legal compliance
        * Timestamped moderator actions
        * Documented reasons for changes
        * Exportable for legal discovery

        **Internal Audits:**

        * Review moderator decision quality
        * Identify patterns in policy enforcement
        * Assess edit necessity and appropriateness
        * Train new moderators with examples
      </Accordion>

      <Accordion title="Quality Assurance">
        **Moderator Performance:**

        * Review editing consistency
        * Assess reason quality
        * Identify training needs
        * Recognize excellence

        **Policy Effectiveness:**

        * Track common violations
        * Identify emerging issues
        * Refine moderation guidelines
        * Measure edit impact
      </Accordion>

      <Accordion title="User Communication">
        **Transparency:**

        * Show users what changed
        * Explain policy enforcement
        * Build trust through visibility
        * Demonstrate fairness

        **Education:**

        * Help users understand violations
        * Provide improvement guidance
        * Show correct alternatives
        * Encourage compliance
      </Accordion>
    </AccordionGroup>
  </Tab>
</Tabs>

## Validation & Error Handling

### Content Validation

<Tabs>
  <Tab title="Block Words">
    ### Block Word Detection

    The system automatically validates edited content against your configured block word list before saving.

    **How It Works:**

    <Steps>
      <Step title="Block Word Detection">
        System scans edited content for configured block words
      </Step>

      <Step title="Error Display">
        Clear error message indicates which words triggered the block
      </Step>

      <Step title="User Correction">
        Moderator modifies content to remove or replace blocked terms
      </Step>

      <Step title="Re-validation">
        System re-checks content upon next save attempt
      </Step>

      <Step title="Successful Save">
        Content saves once all validation checks pass
      </Step>
    </Steps>

    <Warning>
      **Important**: Block word validation applies to edited content even though moderators are editing. This ensures policy consistency and prevents accidental policy violations.
    </Warning>
  </Tab>

  <Tab title="System Errors">
    ### API & Connectivity Issues

    <AccordionGroup>
      <Accordion title="API Connection Failures">
        **Error Scenarios:**

        * Server timeout during save operation
        * API endpoint unavailable
        * Authentication token expired
        * Rate limiting exceeded

        **User Experience:**

        * Clear error message displayed
        * Edit content preserved in editor
        * Retry option provided
        * Unsaved changes warning

        **Resolution Steps:**

        1. Check internet connectivity
        2. Refresh authentication if needed
        3. Retry save operation
        4. Contact support if persistent
      </Accordion>

      <Accordion title="Network Connectivity">
        **Connection Issues:**

        * Internet connection lost
        * Network timeout
        * DNS resolution failures
        * Firewall blocking

        **Handling:**

        * Detect connection status
        * Display connectivity warning
        * Queue changes locally (if possible)
        * Auto-retry when connection restored
        * Prevent data loss
      </Accordion>

      <Accordion title="Concurrent Edit Conflicts">
        **Conflict Scenarios:**

        * Multiple moderators editing same content
        * Content changed by another moderator during edit
        * Version mismatch on save

        **Resolution:**

        * All versions preserved in history
        * Latest save operation wins
        * Both edits visible in change history
        * Conflict notification to moderators
        * Option to review other changes
      </Accordion>

      <Accordion title="Validation Failures">
        **Content Issues:**

        * Character limit exceeded
        * Invalid media format
        * Corrupted file upload
        * Metadata structure errors

        **Error Messages:**

        * Specific validation failure reason
        * Character count if limit exceeded
        * Supported formats for media
        * Suggestions for correction
        * Links to help documentation
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Best Practices">
    ### Error Prevention Strategies

    <AccordionGroup>
      <Accordion title="Pre-Save Checks">
        **Before Saving Edits:**

        * Review content for block words manually
        * Check character limits
        * Verify media file formats
        * Ensure edit reason is clear
        * Preview changes if possible

        **Workflow Tips:**

        * Save frequently for long edits
        * Use draft mode if available
        * Keep original in separate window for reference
        * Document complex changes incrementally
      </Accordion>

      <Accordion title="Connectivity Management">
        **Stable Environment:**

        * Use reliable internet connection
        * Avoid public Wi-Fi for important edits
        * Keep session active during edits
        * Monitor connection status

        **Backup Strategies:**

        * Copy content before major edits
        * Save complex edits in external document first
        * Screenshot original for reference
        * Note key changes in separate log
      </Accordion>

      <Accordion title="Team Coordination">
        **Prevent Conflicts:**

        * Communicate with team about active edits
        * Use assignment systems to claim content
        * Check if others are editing same content
        * Coordinate on complex multi-moderator cases

        **Conflict Resolution:**

        * Review both versions in history
        * Discuss with other moderator if needed
        * Make additional edit if necessary
        * Document coordination in edit reasons
      </Accordion>
    </AccordionGroup>
  </Tab>
</Tabs>

## Use Cases

<CardGroup cols={2}>
  <Card title="Content Quality Control" icon="badge-check">
    **Scenario**: User posts valuable information with minor profanity

    **Solution**:

    * Edit to remove offensive language
    * Preserve valuable content and discussion
    * Add reason: "Removed inappropriate language"
    * Maintain community value while enforcing standards
  </Card>

  <Card title="Privacy Protection" icon="shield-check">
    **Scenario**: User accidentally shares personal contact information

    **Solution**:

    * Remove phone numbers and email addresses
    * Keep rest of post intact
    * Add reason: "Removed personal information for privacy"
    * Protect user while preserving content
  </Card>

  <Card title="Misinformation Correction" icon="circle-exclamation">
    **Scenario**: Post contains factually incorrect information

    **Solution**:

    * Correct false statements
    * Add source references if appropriate
    * Add reason: "Corrected factual inaccuracies"
    * Consider adding moderator note to original
  </Card>

  <Card title="Copyright Compliance" icon="copyright">
    **Scenario**: Post includes copyrighted images without permission

    **Solution**:

    * Remove copyrighted media only
    * Maintain user's text content
    * Add reason: "Removed copyrighted images"
    * Preserve post value while ensuring compliance
  </Card>

  <Card title="Spam Cleanup" icon="broom">
    **Scenario**: Legitimate post with embedded spam links

    **Solution**:

    * Remove spam URLs and promotional content
    * Keep relevant discussion points
    * Add reason: "Removed spam links"
    * Maintain conversation flow
  </Card>

  <Card title="Accessibility Enhancement" icon="universal-access">
    **Scenario**: Media posts lacking proper alt text

    **Solution**:

    * Add descriptive alt text to all media
    * Improve accessibility compliance
    * Add reason: "Added accessibility descriptions"
    * Enhance user experience for all users
  </Card>

  <Card title="Legal Compliance" icon="scale-balanced">
    **Scenario**: Content requires modification for regulatory compliance

    **Solution**:

    * Edit to meet legal requirements
    * Document compliance reason clearly
    * Add reason: "Modified for legal compliance"
    * Maintain audit trail for records
  </Card>

  <Card title="Policy Enforcement" icon="gavel">
    **Scenario**: Content violates specific community guidelines

    **Solution**:

    * Edit to align with community standards
    * Preserve user intent where possible
    * Add reason: "Edited for policy compliance"
    * Use as educational opportunity
  </Card>
</CardGroup>

## Best Practices

<AccordionGroup>
  <Accordion title="Edit vs. Delete Decision Framework">
    **When to Edit:**

    * Content has value but contains violations
    * Minor policy infractions
    * Fixable privacy issues
    * Misinformation that can be corrected
    * Accessibility improvements needed
    * First-time violations by good-faith users

    **When to Delete:**

    * Severe policy violations (harassment, threats)
    * Entirely inappropriate content
    * Spam or bot-generated posts
    * Repeated violations after warnings
    * Legal removal requirements
    * Content with no salvageable value

    **Decision Matrix:**

    | Severity | Value | History | Action          |
    | -------- | ----- | ------- | --------------- |
    | Minor    | High  | First   | ✅ Edit          |
    | Minor    | Low   | First   | ⚠️ Edit or Warn |
    | Moderate | High  | First   | ✅ Edit + Warn   |
    | Moderate | Low   | Repeat  | ❌ Delete        |
    | Severe   | Any   | Any     | ❌ Delete + Ban  |
  </Accordion>

  <Accordion title="Effective Edit Reasons">
    **Clear and Specific:**

    * "Removed profanity (specific words)"
    * "Corrected factual error about X"
    * "Removed personal contact information"
    * "Deleted copyrighted image"

    **Avoid Vague Reasons:**

    * ❌ "Policy violation"
    * ❌ "Inappropriate"
    * ❌ "Fixed"
    * ❌ "Updated"

    **Professional Language:**

    * Neutral and objective tone
    * Focus on policy, not judgment
    * Provide context when helpful
    * Use standard terminology

    **Reason Templates:**

    ```
    Privacy: "Removed personal information (phone/email)"
    Profanity: "Removed offensive language"
    Misinformation: "Corrected factual inaccuracy about [topic]"
    Copyright: "Removed copyrighted content"
    Spam: "Removed promotional links/spam"
    Accessibility: "Added alt text for accessibility"
    Legal: "Modified for legal compliance with [law/regulation]"
    ```
  </Accordion>

  <Accordion title="Maintaining User Trust">
    **Transparency Principles:**

    * Always show edit indicators
    * Provide clear edit reasons
    * Make history accessible
    * Be consistent in enforcement

    **Communication:**

    * Consider notifying users of significant edits
    * Explain policy rationale when appropriate
    * Offer guidance for future compliance
    * Be responsive to questions about edits

    **Fairness:**

    * Apply same standards to all users
    * Document decision rationale
    * Allow for context and intent
    * Provide path to compliance
  </Accordion>

  <Accordion title="Workflow Efficiency">
    **Optimization Strategies:**

    * Use templates for common edit scenarios
    * Develop standardized edit reasons
    * Create team style guide
    * Share best edit examples
    * Automate where appropriate

    **Time Management:**

    * Prioritize high-impact content
    * Batch similar edits when possible
    * Set time limits for complex decisions
    * Escalate edge cases
    * Focus on prevention through education

    **Team Coordination:**

    * Regular calibration sessions
    * Shared edit reason library
    * Peer review for complex cases
    * Clear escalation procedures
    * Knowledge sharing culture
  </Accordion>

  <Accordion title="Quality Assurance">
    **Self-Review Checklist:**

    * [ ] Edit preserves user intent where possible
    * [ ] All policy violations addressed
    * [ ] Edit reason is clear and specific
    * [ ] No introduction of new errors
    * [ ] Accessibility maintained or improved
    * [ ] Change history will make sense to reviewers

    **Peer Review Indicators:**

    * Highly visible content
    * Complex policy questions
    * Significant content changes
    * Sensitive topics
    * Legal implications
    * Unusual circumstances

    **Continuous Improvement:**

    * Review edit outcomes
    * Track user responses
    * Analyze effectiveness metrics
    * Update guidelines based on learnings
    * Share successes and challenges
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="I don't see the Edit option">
    **Possible Causes:**

    * Insufficient permissions
    * Content type not editable (polls, stories, scheduled posts)
    * Content has been deleted
    * Browser cache issues

    **Solutions:**

    1. Verify you have "Edit posts and comments" permission
    2. Check Admin Roles section for your permissions
    3. Confirm content type supports editing
    4. Clear browser cache and reload
    5. Contact administrator to verify role assignment
  </Accordion>

  <Accordion title="Edit won't save - Block word error">
    **Cause**: Content contains words from the block word list

    **Solutions:**

    1. Review error message for specific blocked words
    2. Remove or replace blocked terms
    3. Rephrase content to avoid triggers
    4. Verify block word list is current and appropriate
    5. Contact administrator if block word seems incorrect
  </Accordion>

  <Accordion title="Changes not appearing on user side">
    **Possible Causes:**

    * Cache delay
    * Save operation failed
    * Browser synchronization issue
    * CDN propagation delay

    **Solutions:**

    1. Refresh the page
    2. Check if edit appears in change history
    3. Verify save confirmation was received
    4. Clear browser cache
    5. Wait 1-2 minutes for propagation
    6. Try from incognito/private browser window
    7. Contact support if persistent
  </Accordion>

  <Accordion title="Concurrent edit conflict">
    **Situation**: Another moderator edited the same content

    **What Happens:**

    * Both edits preserved in history
    * Latest save wins for display
    * Both moderators notified

    **Resolution:**

    1. Review both versions in change history
    2. Communicate with other moderator
    3. Make additional edit if needed to reconcile
    4. Document coordination in edit reason
  </Accordion>

  <Accordion title="Change history missing or incomplete">
    **Possible Causes:**

    * Content was deleted (history not retained)
    * More than 10 edits (only latest 10 shown)
    * System error during history recording

    **Solutions:**

    1. Verify content hasn't been deleted
    2. Check that you're viewing the correct content
    3. Remember only 10 most recent edits are shown
    4. Review moderation activity report for full log
    5. Contact support if history appears corrupted
  </Accordion>

  <Accordion title="Media upload fails during edit">
    **Possible Causes:**

    * File size too large
    * Unsupported file format
    * Network connectivity issue
    * Storage quota exceeded

    **Solutions:**

    1. Check file size and compress if needed
    2. Verify file format is supported
    3. Test internet connection
    4. Try uploading one file at a time
    5. Convert files to supported formats
    6. Contact administrator about storage quota
  </Accordion>

  <Accordion title="API or connectivity errors">
    **Error Messages:**

    * "Failed to save changes"
    * "Connection timeout"
    * "Network error"

    **Solutions:**

    1. Check internet connectivity
    2. Refresh authentication session
    3. Copy edited content to clipboard as backup
    4. Try saving again
    5. If persistent, save content externally and contact support
    6. Report error with timestamp and content ID
  </Accordion>
</AccordionGroup>

## Related Topics

<CardGroup cols={3}>
  <Card title="Moderation Overview" icon="shield-halved" href="/analytics-and-moderation/console/moderation/overview">
    Comprehensive moderation workflows and strategies
  </Card>

  <Card title="Roles & Privileges" icon="shield-check" href="/analytics-and-moderation/console/moderation/roles-and-privileges">
    Understanding permissions and role management
  </Card>

  <Card title="Livestream Moderation" icon="video" href="/analytics-and-moderation/console/moderation/livestream-moderation">
    Real-time content moderation for live streams
  </Card>

  <Card title="AI Content Moderation" icon="robot" href="/analytics-and-moderation/console/ai-content-moderation">
    Automated content detection and filtering
  </Card>
</CardGroup>